Tourbot/readme.md

82 lines
6.3 KiB
Markdown
Raw Permalink Normal View History

2024-01-28 00:08:12 -05:00
# Tourbot
### The Friendly Worlds Tour Guide
2024-01-28 00:34:12 -05:00
### Progress: Not finished (teleport needs work)
2024-03-22 11:17:06 -04:00
![Work in Progress](https://files.worlio.com/users/bonkmaykr/http/git/embed/FaFashionAvenueStage8740underconstruction.gif)
2024-01-28 00:08:12 -05:00
Tourbot is an automated chatbot for the Worlds.com online 3D chat service (specifically WorldsPlayer from 1998 and onward). It is based off of P3NG0 by Wirlaburla, the FIRST Worlds chatbot to ever be created and operated live in public. Tourbot retains several features from P3NG0 as well as new features, with the primary selling point being to provide both new and old users an exciting and easy way to explore new worlds, without having to dig through endless archives and file servers like Worlio or jett.dacii.net. This is especially important today as several HOSTs on Worlds have departed or otherwise become inactive, leaving many of the weekly and monthly events abandoned, including tours.
This project is a gift to the Worlds community, and I owe a special thanks to the endless line of nerds who came before me and reverse-engineered the chat protocol so that this could happen.
2024-01-28 23:53:43 -05:00
# To-Do
2024-01-28 23:52:58 -05:00
Underlined tasks are tasks currently being worked on
- [ ] <ins>Core Functions</ins>
2024-01-28 23:53:43 -05:00
- [x] Improved configuration system
2024-01-28 23:56:18 -05:00
- [ ] Strip out old `worldlist.conf` entirely (pair `where` command with `lookUpWorldName()`)
2024-01-28 23:52:58 -05:00
- [ ] <ins>New commands</ins>
- [ ] <ins>Teleport-on-request routine</ins>
2024-01-28 23:53:43 -05:00
- [ ] Basic Tour Guide routine
2024-03-22 11:17:06 -04:00
- [ ] Tour communication (tracking users, prioritize leader commands, whispering users out of range, etc)
2024-01-29 00:27:07 -05:00
- [ ] Ability to join another user's ongoing tour
2024-03-22 11:17:06 -04:00
- [ ] World Database Building
2024-01-28 23:53:43 -05:00
- [ ] Spanish Localization
- [ ] Tour Guide Avatar
2024-01-29 00:27:07 -05:00
- [ ] Contextual Avatars: on tour
- [ ] Contextual Avatars: idle (advertising)
2024-01-28 23:53:43 -05:00
- [ ] Help Pages, Website, and Documentation
2024-01-29 00:27:07 -05:00
- [ ] Tourbot Status Page
- [ ] New User Recognition and Welcome
2024-01-28 23:53:43 -05:00
2024-01-28 00:08:12 -05:00
# Runtime Requirements
2024-03-22 11:17:06 -04:00
- An active IPv4 internet connection
- A valid Worlds.com account which you registered using the WorldsPlayer
- Linux or any other compatible UNIX derivative
2024-01-28 00:08:12 -05:00
- The latest version of glibc
- The actual version required will depend on the version of glibc linked during compile time.
I compile Tourbot on Arch-based distributions which usually have the latest version.
If you use a distro such as Ubuntu or Debian then you may need to compile the bot yourself.
2024-03-22 11:17:06 -04:00
- A working brain
2024-01-28 00:08:12 -05:00
# Building Requirements
- CMake
- GCC
- C++ header/source files from Nlohmann's JSON library
2024-03-22 11:09:30 -04:00
- A few Linux distributions have this library available as an installable package. Please check the repo in your package manager.
2024-01-28 00:08:12 -05:00
- Otherwise you just need to put the required `json.hpp` file in your include path and make sure CMake and GCC can see it.
# Building
2024-03-22 11:09:30 -04:00
## Linux, MINIX and BSD
2024-01-28 00:08:12 -05:00
1. Make sure nlohmann JSON is in your INCLUDE path so your compiler can find it's headers.
2024-03-22 11:09:30 -04:00
- On Arch Linux / endeavourOS: `sudo pacman -Sy nlohmann-json`
- On Ubuntu / Mint / PopOS: `sudo apt-get install nlohmann-json3-dev`
- Other systems: Install and link the library's source files manually.
2024-01-31 20:09:41 -05:00
2. Enter the root directory (where `src` is) and run `cmake -S src/ -B bin/` to create the neccessary files to compile the program.
3. Run `cmake --build bin/` to create an executable file in the bin folder.
4. `cd` to `bin/` and run `./p3ng0`. (Your working directory needs to be the same directory where `conf/` is located.)
2024-01-28 00:08:12 -05:00
## Windows
2024-01-31 20:09:41 -05:00
Tourbot isn't designed for Windows right now. As such, I haven't set up the project files to be compilable on Windows, even with Linux as the target. You can either install WSL and compile there, or set up the compiler yourself if you know what you're doing.
2024-01-28 00:08:12 -05:00
## Mac
2024-01-31 20:09:41 -05:00
I don't use Mac and I never plan to support it, I can't help you.
2024-01-28 00:31:57 -05:00
# FAQ
2024-03-22 11:09:30 -04:00
## When are you going to finish this?
To quote our lord and savior John Carmack, "It will be done when it's done." I'm the only person working on this and I have a real life (crazy I know).
2024-01-28 00:31:57 -05:00
## Can I copy your code?
Yes, but you have to keep the GNU GPL 3 license.
## Where do I report bugs?
Create an issue here on this repository, or send me an email at `bonkmaykr@protonmail.com`.
## Can I deploy this myself on Worlds?
Yes, but please don't try to clog up the servers or chatrooms with a bunch of redundant bots. If Tourbot is working fine, then be nice and let it do it's job unless you can do it better.
I can't stop you from doing whatever you want with it, but if you do bad things your accounts and IP addresses will probably get banned from Worlds, so use Tourbot wisely.
## When I try to log in, the console says "Account is no longer valid".
Double check your spelling.
2024-01-31 20:09:41 -05:00
If you know your username is spelled correctly and the account hasn't been deleted/banned, make sure you saved bot.conf with Unix line endings. Windows line endings use a really funny looking two-byte control code for new lines, and Tourbot doesn't understand how to read them yet. It probably thinks that your username is something like "John<68>" instead of "John". I plan to fix this if a Windows port is ever released, but for now, you will need to be careful with your .conf files.
Many text editors on Windows allow you to change this setting so Tourbot can read your configs correctly, unfortunately the default notepad.exe doesn't include this.
2024-01-28 00:31:57 -05:00
## Why isn't there a Windows version?
2024-01-31 20:09:41 -05:00
P3NG0 was designed from the very beginning with Linux in mind. When it came time to make Tourbot, the same was true; it's designed to be run headless, 24/7, on a server. Meaning you are expected to have a spare computer handy or a cloud VPS rented in order to run the bot. Just about every sane sysadmin uses Linux for headless systems, since Windows was always optimized around it's user interface and not much else.
2024-01-28 00:31:57 -05:00
2024-01-31 20:09:41 -05:00
I could make a Windows version, doing so is actually not very difficult. The code for Tourbot is pretty small and it very rarely interacts with system APIs if at all. It's just a matter of if I want to or not.
## Why are passwords stored in plaintext? That's not safe!
Worlds doesn't have SSL or TLS, doesn't hash passwords, and doesn't have session tokens or revocable sessions. It's a very old program with extremely outdated security. Tourbot isn't secure because the weakest link in the chain makes any security effort on my part pointless. <ins>If you want to remain safe, use a *unique password* for the bot so that it can't be reused in the event it gets stolen.</ins>