redstrate/kawari
1
Fork 0
mirror of https://github.com/redstrate/Kawari.git synced 2025-06-30 11:47:45 +00:00
Code Activity
Server emulator for a certain MMO
556 commits 3 branches 0 tags 4.5 MiB
Find a file
thedax 82e5021979
Implement the //gm teri_info command, and fix a typo (#56) 
Implement the `//gm teri_info` command, and fix a typo. Said typo was in gamedata.rs, confusing the FingerL column for the SoulCrystal column.
2025-06-23 13:39:37 -04:00
.github/workflows Add run script to the artifact 2025-05-03 19:30:09 -04:00
resources Add a placeholder script for the market board and a couple more gatekeepers (#55) 2025-06-22 18:22:44 -04:00
scripts Add run script to the artifact 2025-05-03 19:30:09 -04:00
src Implement the //gm teri_info command, and fix a typo (#56) 2025-06-23 13:39:37 -04:00
.gitignore Add patch-dl.ffxiv.localhost to the default Caddy config 2025-06-08 15:44:22 -04:00
build.rs Skip generating empty opcode enums 2025-06-07 10:57:13 -04:00
Cargo.lock Update Physis to make several zones functional 2025-06-22 10:29:16 -04:00
Cargo.toml Implement the //gm teri_info command, and fix a typo (#56) 2025-06-23 13:39:37 -04:00
CONTRIBUTING.md Fix another link in CONTRIBUTING 2025-06-23 13:31:11 -04:00
LICENSE Relicense to AGPL, remove .build.yml 2024-04-28 08:32:31 -04:00
README.md Mention Lua in the README more 2025-06-22 08:56:04 -04:00
USAGE.md Implement the //gm teri_info command, and fix a typo (#56) 2025-06-23 13:39:37 -04:00

README.md

Kawari

Server emulator for a certain MMO. Updates on the project can be found on my blog.

Features

We have a working implementation for most of FFXIV's servers:

  • Frontier
    • Used for news, gate status and more.
  • Launcher
    • Used to serve the launcher web page.
  • Lobby
    • Create a new character and login to a World server.
  • Login
    • Logging in and creating new accounts.
  • Patch
    • Verifies the game client version. Can't serve patch files yet.
  • World
    • Still limited, but supports basic multiplayer and can explore zones.

Kawari is extendable, and content can be easily scripted using our Lua API. See the resources/scripts folder for examples.

Goals

Kawari is primarily a research project, but also a way to preserve the modern client. Kawari is...

  • FOR preservation of the game, in the event that the servers are permanently unavailable.
  • FOR exploring the packet structure for legitimate purposes (e.g. archival and preservation.)
  • NOT a way to play the game without a valid subscription. The server can't, nor ever will be a suitable replacement for the real game.
  • NOT for creating bots, packet modifications or doing anything on the retail servers.

Also please don't use Kawari to spoil new or unreleased content, thanks.

Supported Game Version

Kawari currently supports patch 7.25h (2025.06.10.0000.0000.) Kawari will never "roll back" to a previous patch. There are other servers (e.g. Sapphire) that support older versions of the game. As Kawari moves to a new major patch, the previous patch is moved to a branch (e.g. 7.1) These branches are for archival: effectively unsupported, but still useful.

Only the Global region is supported. Only the Windows client is supported. Supporting other regions or clients are currently out of scope of this project, but might work anyway.

Running

Kawari is designed to be easy to run. A guide to running Kawari can be followed here.

Contributing

Pull requests for new scripts, features, patch updates, and documentation are welcome. A guide for contributing and updating Kawari can be found here.

Credits & Thank You

License

This project is licensed under the GNU Affero General Public License 3. Some code or assets may be licensed differently.