How hollow-cube/mapmaker works
Map Maker is Hollow Cube’s Minecraft creative map-building server. Players enter a server to build and edit maps; map-world logic, scripting, Terraform editing and replay support provide the main authoring/runtime capabilities, while server binaries delegate persistent storage and processing to the API server. The graph preserves the documented editor, map, compatibility and replay branches. Several subsystem implementations are unsampled, so their internal call relationships are omitted rather than inferred.
Main entry points: Main.java API Server · MapMain.java Map Servers · map Map World · ApiSegmentedReplayStorage.java Replay Runtime
Components 19
Game Servers
- Map Servers
bin/map/src/main/java/net/hollowcube/mapmaker/map/MapMain.java - Isolated Maps
bin/map-isolate/src/main/java/net/hollowcube/mapmaker/isolate/IsolateMain.java - Velocity Proxy
bin/proxy-plugin/src/main/java/net/hollowcube/proxy/ProxyPlugin.java
Map Authoring
- Map World
modules/map-core/src/main/java/net/hollowcube/mapmaker/map - Map Editor
modules/map-editor/src/main/java/net/hollowcube/mapmaker/editor - Terraform Editing
modules/terraform/src/main/java/net/hollowcube/terraform/apply/ApplyEngine.java - Edit Buffer
modules/terraform/src/main/java/net/hollowcube/terraform/buffer/EditBuffer.java
Platform Services
- API Server
bin/api-server/src/main/java/net/hollowcube/apiserver/Main.java - Map Service
bin/api-server/src/main/java/net/hollowcube/apiserver/map/MapServiceImpl.java - Replay Service
bin/api-server/src/main/java/net/hollowcube/apiserver/replay/ReplayServiceImpl.java - Session Service
bin/api-server/src/main/java/net/hollowcube/apiserver/session/SessionServiceImpl.java
Runtime Systems
- Script Engine
modules/map-runtime/src/main/java/net/hollowcube/mapmaker/scripting/ScriptEngine.java - Replay Runtime
modules/map-runtime/src/main/java/net/hollowcube/mapmaker/runtime/replay/ApiSegmentedReplayStorage.java - Replay Format
modules/replay/src/main/java/dev/hollowcube/replay/io/SegmentedReplay.java - Resource Pack
bin/packer/src/main/java/net/hollowcube/mapmaker/Packer.java
Capture and Compatibility
- Anticheat Capture
modules/anticheat/src/main/java/net/hollowcube/anticheat/capture/CaptureEngine.java - Trace Logs
modules/anticheat/src/main/java/net/hollowcube/anticheat/log/TraceWriter.java - Client Compatibility
modules/compat/src/main/java/net/hollowcube/compat/axiom/AxiomPacketHandler.java
Other components
- Map Builder
Connections 17
- Map Builder → Map Servers: builds on
README.md - Map Servers → API Server: delegates storage
README.md - Isolated Maps → API Server: delegates storage
README.md - Map Servers → Map World: hosts maps
- Map Servers → Map Editor: provides editing
- Map Editor → Terraform Editing: applies edits
- Terraform Editing → Edit Buffer: reads edits
modules/terraform/src/main/java/net/hollowcube/terraform/apply/ApplyEngine.java - Map World → Script Engine: runs scripts
modules/map-runtime/src/main/java/net/hollowcube/mapmaker/scripting/ScriptEngine.java - Script Engine → Map World: binds world
modules/map-runtime/src/main/java/net/hollowcube/mapmaker/scripting/ScriptEngine.java - Replay Runtime → Replay Format: loads and writes
modules/map-runtime/src/main/java/net/hollowcube/mapmaker/runtime/replay/ApiSegmentedReplayStorage.java - Replay Runtime → Replay Service: calls replay API
modules/map-runtime/src/main/java/net/hollowcube/mapmaker/runtime/replay/ApiSegmentedReplayStorage.java - API Server → Map Service: hosts map APIs
- API Server → Replay Service: hosts replay APIs
- API Server → Session Service: hosts session APIs
- Anticheat Capture → Trace Logs: assembles traces
modules/anticheat/src/main/java/net/hollowcube/anticheat/capture/CaptureEngine.java - Velocity Proxy → API Server: uses services
- Map Servers → Client Compatibility: supports clients