diff --git a/README.md b/README.md index ebfe2fc8..d4be9d1c 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ newserv is a game server and proxy for Phantasy Star Online (PSO). This project includes code that was reverse-engineered by the community in ages long past, and has been included in many projects since then. It also includes some game data from Phantasy Star Online itself; this data was originally created by Sega. -This project is a rewrite of a rewrite of a game server that I wrote many years ago. So far, it works well with PSO GC Episodes 1 & 2, and lobbies (but not games) are implemented on Episode 3. Some basic functionality works on PSO PC and PSO BB, but there are probably still some cases that lead to errors (which will disconnect the client). +This project is a rewrite of a rewrite of a game server that I wrote many years ago. So far, it works well with PSO GC Episodes 1 & 2, and lobbies (but not games) are implemented on Episode 3. Some basic functionality works on PSO PC and PSO BB, but there are probably still some cases that lead to errors (which will disconnect the client). The proxy works well with PSO GC and PSO BB. Feel free to submit GitHub issues if you find bugs or have feature requests. I'd like to make the server as stable and complete as possible, but I can't promise that I'll respond to issues in a timely manner. @@ -24,12 +24,14 @@ Currently this code should build on macOS and Ubuntu. It will likely work on oth There is a probably-not-too-old macOS release on the newserv GitHub repository (look in the right sidebar). If you're running Linux or want to build newserv yourself, here's what you do: -- Make sure you have CMake and libevent installed. (`brew install cmake libevent` on macOS, `sudo apt-get install cmake libevent-dev` on most Linuxes) +1. Make sure you have CMake and libevent installed. (`brew install cmake libevent` on macOS, `sudo apt-get install cmake libevent-dev` on most Linuxes) - Build and install phosg (https://github.com/fuzziqersoftware/phosg). -- Run `cmake . && make` on the newserv directory. -- In the system/ directory, make a copy of config.example.json named config.json, and edit it appropriately. -- Run `./newserv` in the newserv directory. This will start the game server and run the interactive shell. You may need `sudo` if newserv's built-in DNS server is enabled. -- Use the interactive shell to add a license. Run `help` in the shell to see how to do this. +2. Run `cmake . && make` on the newserv directory. + +After building newserv or downloading a release, do this to set it up and use it: +1. In the system/ directory, make a copy of config.example.json named config.json, and edit it appropriately. +2. Run `./newserv` in the newserv directory. This will start the game server and run the interactive shell. You may need `sudo` if newserv's built-in DNS server is enabled. +3. Use the interactive shell to add a license. Run `help` in the shell to see how to do this. ### Installing quests diff --git a/system/blueburst/keys/tfs1.nsk b/system/blueburst/keys/tfs1.nsk new file mode 100755 index 00000000..de83d6ee Binary files /dev/null and b/system/blueburst/keys/tfs1.nsk differ diff --git a/system/config.example.json b/system/config.example.json index e8a78ca6..e8193cc0 100644 --- a/system/config.example.json +++ b/system/config.example.json @@ -40,7 +40,9 @@ // Ephinea PSOBB uses these ports. Note that 13000 is also used by Schthack // PSOBB, but not for the patch server; this means you unfortunately can't - // support both Schthack and Ephinea PSOBB clients at the same time. + // support both Schthack and Ephinea PSOBB clients at the same time. This + // may be fixed in the future using a similar technique as the + // split_reconnect behavior, but this isn't implemented yet. // "bb-patch3": [13000, "patch", "patch_server"], // "bb-init3": [14000, "bb", "data_server_bb"], @@ -86,10 +88,10 @@ // "RunInteractiveShell": false, // By default, the server only allows users who are registered in the license - // file to connect. By enabling this option, all users will be allowed to - // connect. This option has no effect for Blue Burst clients; they are always - // required to be registered before connecting. Keep in mind that unregistered - // users cannot be banned! + // file to connect. By enabling this option, all non-BB users will be allowed + // to connect. This option has no effect for Blue Burst clients; they are + // always required to be registered before connecting. Keep in mind that + // unregistered users cannot be banned! "AllowUnregisteredUsers": false, // User to run the server as. If present, newserv will attempt to switch to