docs: added readme.md

This commit is contained in:
əlemi 2024-10-03 19:05:35 +02:00
parent 529c76b54b
commit 1c68f852fd

25
README.md Normal file
View file

@ -0,0 +1,25 @@
# collarmc
when playing on _some_ vanilla servers, you end up going very fast to reach distant places. like, VERY fast!!
playing with friends like this is incredibly annoying because they blink in and out of render distance, making coordinating awful.
`collarmc` aims to solve this: with a super simple websocket backend, users can join a room and directly share their coordinates.
this is only half of the system: the server. clients will need to have an extension which connects to this websocket backend and force spawns players in world.
## inspiration
this project is a clone of https://github.com/collarmc. their site is down and their software is a bit too complex for my tastes.
original project also had text and voice chat, plus emojis and more. i don't care about that, i only want positions share.
so i decided to rewrite it, trying to dramatically simplify the project.
## security
there are no user accounts, when connecting you tell on which "room" to join, and all your position packets will be sent to any other user in the same "room".
to have secure sessions, make sure to choose a hard to guess room id, consider it as your "session password". you should also use a new one every time.
to avoid bad actors from bruteforcing room passwords, consider running fail2ban on the server, or just use VERY long passwords (128+ chars)