How nikkiii/hyperion works
Hyperion is a Java RuneScape gameserver suite. Clients connect to the game server for login and gameplay; the world loads configuration and map data, then the game engine runs player and world logic and serves protocol updates. A separate file server streams cache data, while an optional login-server connection supports multi-world coordination and cross-world messaging. The graph preserves these documented capabilities, but unsampled modules and their internal wiring are represented conservatively; dashed edges mark relationships documented by the README rather than shown in sampled code.
Main entry points: World.java World state · Player.java Player state · Server.java Server launcher · ObjectManager.java Object loading
Components 20
Server runtime
- Server launcher
src/org/hyperion/Server.java - Game server
src/org/hyperion/rs2/RS2Server.java - Session handler
src/org/hyperion/rs2/ConnectionHandler.java - Packet routing
src/org/hyperion/rs2/net/PacketManager.java - Game packet handlers
src/org/hyperion/rs2/packet/PacketHandler.java
Game world
- World state
src/org/hyperion/rs2/model/World.java - Game engine
src/org/hyperion/rs2/GameEngine.java - Player state
src/org/hyperion/rs2/model/Player.java - Region manager
src/org/hyperion/rs2/model/region/RegionManager.java - Object loading
src/org/hyperion/rs2/model/ObjectManager.java - Actions and events
src/org/hyperion/rs2/action
Cache delivery
- Update server
src/org/hyperion/fileserver/FileServer.java - Update requests
src/org/hyperion/fileserver/RequestHandler.java - Cache reader
src/org/hyperion/cache/Cache.java
Multi-world login
- Login server
src/org/hyperion/ls/LoginServer.java - World node
src/org/hyperion/ls/Node.java - Node registry
src/org/hyperion/ls/NodeManager.java - Login connector
src/org/hyperion/rs2/login/LoginServerConnector.java
Other components
- Game client
- Cache client
Connections 23
- Server launcher → World state: initializes
src/org/hyperion/Server.java - Server launcher → Update server: starts
src/org/hyperion/Server.java - Server launcher → Game server: starts
src/org/hyperion/Server.java - Game client → Game server: connects
- Game server → Session handler: accepts sessions
- Session handler → Packet routing: dispatches packets
- Packet routing → Game packet handlers: routes by opcode
src/org/hyperion/rs2/net/PacketManager.java - Game packet handlers → Player state: handles player input
src/org/hyperion/rs2/packet/PacketHandler.java - World state → Game engine: owns
src/org/hyperion/rs2/model/World.java - Game engine → World state: runs logic for
src/org/hyperion/rs2/GameEngine.java - World state → Object loading: loads objects
src/org/hyperion/rs2/model/ObjectManager.java - Object loading → Cache reader: reads cache
src/org/hyperion/rs2/model/ObjectManager.java - Object loading → Region manager: places objects
src/org/hyperion/rs2/model/ObjectManager.java - Region manager → Player state: queries nearby players
src/org/hyperion/rs2/model/region/RegionManager.java - Player state → Actions and events: queues actions
src/org/hyperion/rs2/model/Player.java - Update server → Update requests: handles requests
- Update requests → Cache reader: serves cache files
src/org/hyperion/fileserver/RequestHandler.java - Cache client → Update server: requests updates
- World state → Login connector: configures optional login
src/org/hyperion/rs2/model/World.java - Login connector → Login server: connects for worlds
- Login server → World node: manages world nodes
src/org/hyperion/ls/Node.java - Node registry → World node: registers nodes
src/org/hyperion/ls/NodeManager.java - World node → Player state: loads player state
src/org/hyperion/ls/Node.java