serve minecraft with a simple chat logging web interface
Want to see pretty graphs? Log in now!
npm install mcserve
|1||downloads in the last week|
|46||downloads in the last month|
|Last Published By|
|Version||0.5.0 last updated a year ago|
|Dependencies (7)||superagent, minecraft-protocol, express, connect-sse, connect-xcors, connect-nocache, moment|
(Pronounced "mick surv")
Console wrapper and proxy for Minecraft 1.5 server.
- Web interface with recent chat history and who is online.
- Automatically restart minecraft server when it crashes.
- Provide extra commands to users
- Sets online-mode for a whitelist or blacklist of people.
Extra Commands for Users
/help mcserve- in game help for mcserve commands
/restart: Requests a server restart which will happen after everybody logs off.
/seen <username>: Tells how long ago username was seen on the server.
/bot- create, destroy, list, tp bots on a mc-bot-server
/version- get the mcserve version
/whitelist- manage who is on the whitelist (or blacklist)
/admin- manage who has access to admin commands
- Install Java.
- Install node.js.
online-modeto false in
server.properties. Authentication and encryption is handled by this project.
npm install mcserve
mcserve.json.exampleto your minecraft server folder and rename it to
- Change any configuration that you need to (see below)
npm start mcserve
disableProxy- set to
trueto skip starting the proxy server
proxyPort- port that the proxy listens on
proxyHost- host that the proxy binds to
proxyRemoteHost- the hostname that the bot server should connect bots to
webPort- the port that the web interface listens on
webHost- the host that the web interface binds to
minecraftPort- the port that the real minecraft server will listen on. Make sure this is the same as the
server-portproperty in minecraft's
minecraftHost- the host that the real minecraft server will listen on. Make sure this is the same as the
server-ipproperty in minecraft.'s
online-mode- whether you want the proxy to authenticate usernames with the official server. you can set exceptions with
onlineModeExceptions. No matter what you choose, you must set
onlineModeExceptions- in online mode, this is usernames which are not checked. in offline mode, this is usernames which are checked.
encryption- whether to turn on protocol encryption
kickTimeout- how many milliseconds to wait before kicking a client which is failing to send heartbeat messages
motd- little blurb that is displayed in the server list
max-players- limit number of people who can connect to the proxy
admins- these people can add and remove people from
botServerEndpoint- URL to a running mc-bot-server which players can use to spawn bots.
botServerApiKey- the api key that you need to give to mc-bot-server