cuwo is an open server implementation for Cube World, written in Python and C++. It currently has the best protocol coverage among all the server projects out there, and has features like
- Cross-platform support (Linux, Windows, Mac OS X, FreeBSD, what have you)
- File/console logging
- MOTD message
- Scripting (see the minimal welcome.py example)
- Advanced configuration
- Ban system
- Commands (/kick, /say, /whereis, /setclock, /kill, /stun. etc.)
- Rights management (/login password)
- IRC bot
- PvP script
- DDoS prevention
- Lower CPU requirements than normal server
- Optimizations in C++
- Master server on http://cuwo.org
- Support for 40+ players
- ... and much more!
See the quick-start guide for a quick way to get started.
Alternatively, you can also build from source.
Make sure you have Python >= 3.3 and cython installed on your machine, along
with native compilers.
On Python versions below 3.4, you will need asyncio installed.
If you want IRC bot support, you will also need the irc3 package
These packages can be installed with pip install cython irc3 asyncio
To build cuwo, run python setup.py build_ext --inplace.
To run the server, run python -m cuwo.server.
For more information, see this guide.
In terms of the protocol and features, the following has been implemented:
- Player join/leave
- Player movement and animations
- Magic/arrows/etc. relay
- Player hits on entities/other players
- Item pickup/drop
- Time management
- Terrain generator
- Interactive objects (doors, beds)
A lot is still to be implemented gameplay-wise. Most importantly, NPCs and mobs have not been implemented yet. The terrain generator is completely working now, but work still needs to be put into creating intelligent AI and proper behaviour.
Other features include
- MITM proxy (for reverse-engineering)
- Cube World/Qubicle model converter (tools/convertqmo.py)
- Map viewer (tools/mapviewer.py)
-
Q. I get
ImportError: No module named 'cuwo.entity'when running cuwo. -
A. See the instructions for running/building cuwo.
-
Q. How do I pronounce 'cuwo'?
-
A. 'coo-woo' (no, not 'kew-woh')
-
Q. I am not a programmer, and I can't reverse-engineer anything. How do I help?
-
A. We need people who can create end-user documentation as well! Have a look around, and see if anything is missing on the wiki.
-
Q. What is a MITM proxy?
-
A. A MITM proxy sits between your client and server, and can manipulate and inject packets. It's not really useful to the normal user, so use the regular cuwo server instead.
-
Q. Can I donate to the project somehow?
-
A. Yes! You don't have to, of course, but it will help bring the server forward.
-
Sarcen - help with protocol variables, scripting, anticheat
Perl - protocol RE
ZeZeene - web interface for master server
Lord_Nightmare - terraingen help and support with x86
Kyle - master server JS
MazeXD - master server JS and design
cs475x - website design
Kainzo - testing
uwee - protocol variables
Somer - help with some protocol variables
Favorlock - scripting and commands
SLoW - scripting
DRayX - encrypt.py and protocol RE
MAT4DOR - cub model details
Xaymar - RE and character details