snootic/minecraft-server-builder
Watch
1
0
Fork
You've already forked minecraft-server-builder
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

WIP: Self hosting support with docker engine #1

Draft
Snootic wants to merge 1 commit from host-integration into main
pull from: host-integration
merge into: snootic:main
Conversation 0 Commits 1 Files changed 19 +1958 -4
Snootic commented 2026-06-14 20:52:11 -03:00 (Migrated from github.com)
Copy link

Roadmap & Execution Checklist

Host connection, networking, and the baseline generation of Minecraft containers.

  • 1.1. Host Integration
    • Multi-platform detection.
    • Resolve data directories.
    • Establish connection to the host's Docker Engine.
    • Provide server data
  • 1.2. Network & Routing
    • Manage isolated network for Minecraft Containers
    • Support itzg/mc-router container for proxying.
  • 1.3. itzg/minecraft-server Mapping
    • Map server configuration options to itzg environment variables (TYPE=FABRIC, MODRINTH_PROJECTS etc.).
    • Correctly map AiKAR and MeowICE flags.
    • Either replace server.properties directly or Implement CFG_ prefix mappings to translate user modified configurations directly into the container's internal properties.

Container Lifecycle Management

  • 2.1. Lifecycle Endpoints
    • Implement START, STOP (SIGTERM), and RESTART endpoints.
    • KILL endpoint for frozen instances.
    • DELETE workflow that unlinks, stops the container and wipe data.

Live monitoring

  • 3.1. Container resource monitor
    • stream real-time container metrics (CPU, Memory, I/O Usage).
  • 3.2. Server Health Checks
    • Add SLP client.
  • 3.3. Console Log Streaming
    • Websocket logging stream to fetch container logs

Web Dashboard

  • 4.1. UI
    • Grid view displaying cards for all active servers (Status indicators, Player counts, resource usage bars).
    • Modular detail view exposing lists of active mods, plugins, datapacks, and quick-toggle options for game rules.
    • Terminal display for logging streaming and RCON access.
# Roadmap & Execution Checklist ### Host connection, networking, and the baseline generation of Minecraft containers. - [ ] **1.1. Host Integration** - [x] Multi-platform detection. - [x] Resolve data directories. - [x] Establish connection to the host's Docker Engine. - [ ] Provide server data - [ ] **1.2. Network & Routing** - [x] Manage isolated network for Minecraft Containers - [ ] Support `itzg/mc-router` container for proxying. - [ ] **1.3. `itzg/minecraft-server` Mapping** - [ ] Map server configuration options to `itzg` environment variables (`TYPE=FABRIC`, `MODRINTH_PROJECTS` etc.). - [ ] Correctly map AiKAR and MeowICE flags. - [ ] Either replace `server.properties` directly or Implement `CFG_` prefix mappings to translate user modified configurations directly into the container's internal properties. --- ### Container Lifecycle Management - [ ] **2.1. Lifecycle Endpoints** - [ ] Implement `START`, `STOP` (SIGTERM), and `RESTART` endpoints. - [ ] `KILL` endpoint for frozen instances. - [ ] `DELETE` workflow that unlinks, stops the container and wipe data. --- ### Live monitoring - [ ] **3.1. Container resource monitor** - [ ] stream real-time container metrics (CPU, Memory, I/O Usage). - [ ] **3.2. Server Health Checks** - [ ] Add SLP client. - [ ] **3.3. Console Log Streaming** - [ ] Websocket logging stream to fetch container logs --- ### Web Dashboard - [ ] **4.1. UI** - [ ] Grid view displaying cards for all active servers (Status indicators, Player counts, resource usage bars). - [ ] Modular detail view exposing lists of active mods, plugins, datapacks, and quick-toggle options for game rules. - [ ] Terminal display for logging streaming and RCON access.
This pull request is marked as a work in progress.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin host-integration:host-integration
git switch host-integration

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main
git merge --no-ff host-integration
git switch host-integration
git rebase main
git switch main
git merge --ff-only host-integration
git switch host-integration
git rebase main
git switch main
git merge --no-ff host-integration
git switch main
git merge --squash host-integration
git switch main
git merge --ff-only host-integration
git switch main
git merge host-integration
git push origin main
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
bug
Something isn't working

  
documentation
Improvements or additions to documentation

  
duplicate
This issue or pull request already exists

  
enhancement
New feature or request

  
good first issue
Good for newcomers

  
help wanted
Extra attention is needed

  
invalid
This doesn't seem right

  
question
Further information is requested

  
wontfix
This will not be worked on

No labels
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
snootic/minecraft-server-builder!1
No description provided.