Sign inSign up

jimurrito/minceraft

By jimurrito

•Updated about 1 month ago

A simple Forge Minecraft server, running in a docker container.

Image
Web servers
Databases & storage
1

3.3K

jimurrito/minceraft repository overview

⁠(Minceraft) Minecraft Neoforge Docker Container

A simple NeoForge Minecraft server, running in a docker container. Supports both x86_64 and arm64 hardware architecture.

⁠Minecraft versions supported

  • 1.21.1
  • 1.20.4

⁠Getting Started

⁠Simple run with all defaults.
docker run -it \
    --name minceraft \
    -p 25565:25565 \
    -v /minceraft:/server \
    jimurrito/minceraft:latest

Using latest docker tag will pull whatever is the newest support minecraft/forge version used by Minecraft. If you want to play on a specific version, you can use the tag. I.E: jimurrito/minceraft:1_21_1 for version 1.21.1.

⁠Run with imported mods & Customized server config
docker run -it \
    --name minceraft \
    -v /path/to/mods:/mods \
    -e LEVELNAME="My Minceraft Server" \
    -e LEVELSEED="docker" \
    -p 25565:25565 \
    -v /minceraft:/server \
    jimurrito/minceraft:latest
⁠Run with imported mods & Customized server config in a .env file.
docker run -it \
    --name minceraft \
    -v /path/to/mods:/mods \
    -v /path/to/logs:/logs \
    --env-file ./server.env \
    -p 25565:25565 \
    -v /minceraft:/server \
    jimurrito/minceraft:latest

./server.env

LEVELNAME="My Minceraft Server"
LEVELSEED="docker"
MOTD="I love Minceraft!"

⁠Parameters

All options within the server.properties file have been ported to environmental variables. Using these variables, the server.properties file is regenerated on each startup of the container. It's recommended to use a .env file for your variables to avoid unexpected changes to your server configuration.

⁠Minecraft Server settings

Options below are used to generate server.properties on each start-up.

VariableDescriptionDefault
ALLOWFLIGHTAllows players to fly in Survival modefalse
ALLOWNETHERAllows players to travel to the Nethertrue
BROADCASTCONSOLETOOPSSends console commands to operatorstrue
BROADCASTRCONTOOPSSends RCON commands to operatorstrue
BUGREPORTLINKURL for bug reporting""
DEBUGEnables debug modefalse
DIFFICULTYSets the difficulty level (peaceful, easy, normal, hard)easy
ENABLECOMMANDBLOCKEnables command blockstrue
ENABLEJMXMONITORINGEnables JMX monitoringfalse
ENABLEQUERYEnables GameSpy4 protocol server listenerfalse
ENABLERCONEnables remote access to the server consolefalse
ENABLESTATUSEnables server statustrue
ENFORCESECUREPROFILEEnforces secure profilestrue
ENFORCEWHITELISTEnforces the whitelistfalse
ENTITYBROADCASTRANGEPERCENTAGEEntity broadcast range percentage100
FORCEGAMEMODEForces players to join in the default game modefalse
FUNCTIONPERMISSIONLEVELPermission level for function commands2
GAMEMODESets the game mode (survival, creative, adventure, spectator)survival
GENERATESTRUCTURESGenerates structures like villagestrue
GENERATORSETTINGSCustom generator settings{}
HARDCOREEnables hardcore modefalse
HIDEONLINEPLAYERSHides online players from the server listfalse
INITIALDISABLEDPACKSInitial disabled data packs""
INITIALENABLEDPACKSInitial enabled data packsvanilla
LEVELNAMEName of the levelworld
LEVELSEEDSeed for the level generator""
LEVELTYPEType of the level generatorminecraft:normal
LOGIPSLogs player IP addressestrue
MAXCHAINEDNEIGHBORUPDATESMaximum chained neighbor updates1000000
MAXPLAYERSMaximum number of players20
MAXTICKTIMEMaximum tick time60000
MAXWORLDSIZEMaximum world size29999984
MOTDMessage of the dayA Minecraft Server
NETWORKCOMPRESSIONTHRESHOLDNetwork compression threshold256
ONLINEMODEServer verifies connecting playerstrue
OPPERMISSIONLEVELOperator permission level4
PLAYERIDLETIMEOUTPlayer idle timeout0
PREVENTPROXYCONNECTIONSPrevents proxy connectionsfalse
PVPEnables player vs player combattrue
QUERYPORTQuery port25565
RATELIMITRate limit for packets0
RCONPASSWORDRCON password""
RCONPORTRCON port25575
REGIONFILECOMPRESSIONRegion file compression methoddeflate
REQUIRERESOURCEPACKRequires players to use the resource packfalse
RESOURCEPACKURL to the resource pack""
RESOURCEPACKIDResource pack ID""
RESOURCEPACKPROMPTResource pack prompt message""
RESOURCEPACKSHA1SHA-1 hash of the resource pack""
SERVERIPServer IP address""
SERVERPORTServer port25565
SIMULATIONDISTANCESimulation distance10
SPAWNANIMALSSpawns animalstrue
SPAWNMONSTERSSpawns monsterstrue
SPAWNNPCSSpawns NPCstrue
SPAWNPROTECTIONSpawn protection radius16
SYNCCHUNKWITESSynchronizes chunk writestrue
TEXTFILTERINGCONFIGText filtering configuration""
USENATIVETRANSPORTUses native transporttrue
VIEWDISTANCEView distance10
WHITELISTEnables the whitelistfalse

For more information, please checkout the Minecraft Wiki⁠

Tag summary

Content type

Image

Digest

sha256:799b2b468…

Size

940.8 MB

Last updated

about 1 month ago

docker pull jimurrito/minceraft