houdini/README.md

90 lines
3.1 KiB
Markdown
Raw Normal View History

2019-09-12 00:09:35 +00:00
<p align="center">
<img alt="houdini-asyncio" src="https://user-images.githubusercontent.com/32749673/64740929-d4435c00-d4ee-11e9-9b9f-f45236b8b61f.png">
</p>
#
<p align="center">
2019-09-21 16:39:42 +00:00
<a href="https://discord.gg/UPnWKfh">
<img
alt="Solero Discord"
src="https://img.shields.io/discord/323290581063172096?color=7289DA&label=discord"
/>
</a>
<a href="https://solero.me">
<img
alt="Solero Forum"
src="https://img.shields.io/discourse/https/solero.me/topics?color=73afb6"
/>
</a>
2020-06-16 21:29:39 +00:00
<a href="https://github.com/Solero/houdini/issues">
2019-09-21 16:39:42 +00:00
<img
alt="Issue Tracker"
src="https://img.shields.io/github/issues/solero/houdini-asyncio"
/>
</a>
<a href="./LICENSE">
<img
alt="License"
src="https://img.shields.io/github/license/solero/houdini-asyncio"
/>
</a>
2020-04-07 23:07:29 +00:00
<a href="https://houdini.readthedocs.io/">
<img
alt="Documentation"
src="https://readthedocs.org/projects/houdini/badge/?version=latest&style=flat"
/>
</a>
2019-09-12 00:09:35 +00:00
</p>
<p align="center">A lightning-fast Club Penguin Private Server written in Python 3.</p>
2020-04-07 23:07:29 +00:00
- [Join our community](https://solero.me)
- [Documentation](https://houdini.readthedocs.io)
2019-09-12 00:09:35 +00:00
## Features :space_invader:
2019-09-21 16:39:42 +00:00
- :clock3: **Cross-era**: Different clients can play together on the same server.
- :exclamation: **Commands**: Built-in extensible commands API.
- :electric_plug: **Powerful Plugin API**: Easy and quick to write your own plugins.
- :speech_balloon: **Chat-filter**: Filter trolls with minimal configuration.
- :shield: **Permissions**: API to restrict access to server functionality & commands.
2019-09-12 00:09:35 +00:00
## Installation
Houdini can be run as a normal Python program under any operating system.
***NOTE**: Houdini requires Python 3.8.x to be installed*
2019-09-12 00:09:35 +00:00
```shell
2020-06-16 21:29:39 +00:00
$ git clone https://github.com/solero/houdini
$ cd houdini
2019-09-12 00:09:35 +00:00
$ pip install -r requirements.txt
$ python bootstrap.py login
2019-09-12 00:09:35 +00:00
```
## Installation with Docker
You can also use [Wand](https://github.com/solero/wand), a tool that installs Houdini, Dash and many other useful tools to compliment your experience.
This is especially useful for those who want a straightforward installation, where everything is installed for you!
Currently Wand only works on Linux servers. Windows and Mac servers could work but requires extra work!
2019-09-12 00:09:35 +00:00
## Game Screenshots
<img alt="Screenshot" width="700px" src="https://user-images.githubusercontent.com/32749673/64743472-05745a00-d4f8-11e9-9eed-f3565dc2e821.png">
<img alt="Screenshot" width="700px" src="https://user-images.githubusercontent.com/32749673/64743711-d8747700-d4f8-11e9-9bab-de08090db34d.png">
<img alt="Screenshot" width="700px" src="https://user-images.githubusercontent.com/32749673/64743891-854ef400-d4f9-11e9-8d78-9d73493eb04d.png">
## Contributing
2019-09-21 16:39:42 +00:00
2019-09-12 00:09:35 +00:00
:heartpulse: So glad to hear of your interest!
If you have suggestions for how this project can be improved, or want to report a bug, please feel free to open an issue! We welcome any and all contributions. We listen to all your questions and are always active on the [Solero Discord server](https://solero.me/t/join-the-discord-server/17).
2019-09-12 00:09:35 +00:00
## License
2019-09-21 16:39:42 +00:00
MIT Licensed