blob: fea6ae5ae45ef1090955bffe30a6bf8d30b121d7 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
.. raw:: html
<p align="center">
<a href="https://github.com/Whirlsplash/whirl">
<img
src="https://raw.githubusercontent.com/Whirlsplash/assets/master/Whirl.png"
alt="Whirl"
width="220">
</a>
</p>
<h1 align="center">The Open-Source WorldServer.</h1>
<p align="center">
.. image:: https://img.shields.io/discord/821938182274154506
:alt: Discord
:target: https://discord.com/invite/8hn6padWF6
.. image:: https://www.codefactor.io/repository/github/whirlsplash/whirl/badge
:alt: CodeFactor
:target: https://www.codefactor.io/repository/github/whirlsplash/whirl
.. image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg
:alt: Say Thanks
:target: https://saythanks.io/to/[email protected]
.. image:: https://img.shields.io/github/license/Whirlsplash/whirl
:alt: License
:target: ./LICENSE
.. raw:: html
</p>
Whirl, an open-source implementation of the
`WorldServer <http://dev.worlds.net/private/GammaDocs/WorldServer.html>`_
protocol in `Rust <https://www.rust-lang.org/>`_.
Purpose
-------
Two *main* reasons;
1. Worlds' official servers are old, slowly deteriorating, and *probably unmaintained*.
2. Worlds is **old**. The shutdown of the servers is inevitable.
**TLDR**: To keep Worlds' legacy going for future generations.
Usage
-----
Use in production environments is **not** recommended as this project is currently under heavy
development.
As stability increases, periodic updates regarding production use will be released (via Discord or
blog).
Documentation
-------------
Documentation about the entire Whirlsplash ecosystem can be found
`here <https://whirlsplash.org/docs/>`_.
If you are looking for explicit documentation of only Whirl's source code, you
must generate them yourself be cloning the repository and running the Cargo
subcommand: :code:`cargo +nightly doc --open --document-private-items --no-deps`.
Known Issues
------------
- https://github.com/Whirlsplash/whirl/issues/2
Contributing
------------
Please reference the `contribution guidelines <./CONTRIBUTING.md>`_ of this repository.
Development Dependencies
------------------------
Required
~~~~~~~~
- `Rust <https://www.rust-lang.org/>`_
- `diesel\_cli <https://crates.io/crates/diesel_cli>`_
- `cargo-make <https://github.com/sagiegurari/cargo-make>`_
Optional
~~~~~~~~
- `cargo-watch <https://crates.io/crates/cargo-watch>`_
- `sqlfluff <https://github.com/sqlfluff/sqlfluff>`_
*These development dependencies (exlcluding sqlfluff) will automatically be satisfied if you are using the Nix shell
configuration as provided.*
License
~~~~~~~
`GNU General Public License v3.0 <./LICENSE>`_
|