mirror of
https://github.com/danbulant/flying-squid
synced 2026-06-11 02:21:18 +00:00
89 lines
3.1 KiB
Markdown
89 lines
3.1 KiB
Markdown
flying-squid
|
|
================
|
|
|
|
[](http://npmjs.com/package/flying-squid)
|
|
[](https://gitter.im/mhsjlw/flying-squid?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
[](LICENSE)
|
|
[](http://wiki.vg/Protocol)
|
|
[](https://img.shields.io/github/issues/mhsjlw/flying-squid.svg)
|
|
[](https://circleci.com/gh/mhsjlw/flying-squid)
|
|
[](https://gratipay.com/~mhsjlw/)
|
|
|
|
A semi-functional minecraft server in Node.js
|
|
|
|
## Features
|
|
* Support for Minecraft 1.8
|
|
* Players can see the world
|
|
* Players see each other in-game and in tab
|
|
* Digging
|
|
* Placing blocks
|
|
* Player movement
|
|
* World generation
|
|
* Anvil loading
|
|
* Multi-world
|
|
|
|
## Test server
|
|
|
|
* rom1504.fr (Port 25565) using [auto-squid](https://github.com/rom1504/auto-squid)
|
|
|
|
## Building / Running
|
|
Before running or building it is recommended that you configure the server in `config/settings.json`
|
|
|
|
npm install
|
|
node app.js
|
|
|
|
Or try our autoupdating flying-squid server [autonomous-squid](https://github.com/mhsjlw/autonomous-squid)
|
|
|
|
You can also install flying-squid globally with `sudo npm install -g flying-squid`
|
|
and then run it with `flying-squid` command.
|
|
|
|
## Plugins
|
|
|
|
* [flying-squid-irc](https://github.com/rom1504/flying-squid-irc) a bridge between a irc chan and the minecraft server.
|
|
Currently used between our test server (rom1504.fr) and our gitter room (through the official gitter irc bridge)
|
|
|
|
## Documentation
|
|
Documentation for how to operate and how to customize your server are coming soon!
|
|
|
|
## Development Documentation
|
|
For development see [API.md](doc/API.md), [CONTRIBUTE.md](doc/CONTRIBUTE.md) and [HISTORY.md](doc/HISTORY.md)
|
|
|
|
## Using as a lib
|
|
|
|
flying-squid is also a server lib. Here is a basic example of usage:
|
|
|
|
```js
|
|
var mcServer = require("flying-squid");
|
|
|
|
mcServer.createMCServer({
|
|
"motd": "A Minecraft Server \nRunning flying-squid",
|
|
"port": 25565,
|
|
"max-players": 10,
|
|
"online-mode": true,
|
|
"logging": true,
|
|
"gameMode": 1,
|
|
"generation": {
|
|
"name": "diamond_square",
|
|
"options":{
|
|
"worldHeight": 80
|
|
}
|
|
},
|
|
"kickTimeout": 10000,
|
|
"plugins": {
|
|
|
|
},
|
|
"modpe": false,
|
|
"view-distance": 10
|
|
});
|
|
```
|
|
|
|
You can add server plugins and player plugins in your package, following [CONTRIBUTE.md](doc/CONTRIBUTE.md).
|
|
|
|
## Contributors
|
|
|
|
- [@roblabla](https://github.com/roblabla) for helping out with the protocols
|
|
- [@rom1504](https://github.com/rom1504) for massive contributions to the code
|
|
- [@demipixel](https://github.com/demipixel)
|
|
- The PrismarineJS team for creating prismarine-chunk and node-minecraft-protocol
|
|
- [wiki.vg](http://wiki.vg/Protocol) for documenting minecraft protocols
|
|
- All of our other awesome contributors!
|