Updated on: 2026-03-15
This repository contains the client and server source code for a Priston Tale base used in projects such as Fortress PT, Regnum PT, PristonTale EU, and Epic Tale.
The repository now also includes local documentation for:
- analyzing the
Files/runtime pack - restoring the database and starting a local environment
- finding GM/Admin commands
- understanding the helper scripts without needing to read the source first
- creating test accounts and characters
- patching the client runtime to localhost
- looking up item codes, numeric item IDs, map IDs, and monster IDs
game/: client source codeServer/: login server and game server source codeshared/: shared structures and typesdocs/: documentation split into guides, analysis, reference, studies, and troubleshootingscripts/: SQL helpers, start/stop scripts, and lookup utilitiesFiles/: local runtime pack with client, server binaries, and database backups
Files/ is treated as a local runtime pack.
- it is large and normally should not be committed to Git
- it is the runtime used for local testing
- if the source and the runtime binaries disagree, document the mismatch clearly
If you want to boot the local environment quickly:
- read server-start-guide.md
- start SQL with
.\scripts\start-pt-docker-sql.ps1 - restore the databases with
.\scripts\restore-pt-docker-dbs.ps1 - patch the client if needed with
.\scripts\patch-pt-client-localhost.ps1 - apply local runtime fixes with
.\scripts\fix-pt-local-runtime.ps1 - start the servers with
.\scripts\start-pt-server.ps1 - open
Files/Game/Game.exe
Documented local test accounts:
admin/admindedezin/dedezin123
- docs/README.md: documentation index
- server-start-guide.md: direct guide for starting, monitoring, and stopping the server
- setup-run-test-guide.md: full local setup and test guide
- gm-handbook.md: practical in-game GM/Admin handbook
- account-and-character-management.md: account creation, GM levels, character ownership, and DB edits
- client-localhost-patch-guide.md: explains the
game.dlllocalhost patch - scripts-handbook.md: plain-English explanation of every helper script
- events-and-rates-guide.md: EXP, drop, events, and maintenance guide
- project-analysis.md: technical analysis of the runtime pack
- server-commands-reference.md: command reference for player, GM1, GM2, GM3, and GM4/Admin commands
- item-code-and-data-reference.md: where to find item codes, item IDs, drop data, and monster data
- docs/reference/ids/README.md: dedicated ID lookup section
- local-runtime-known-issues.md: real issues already seen in the current local runtime
- start-pt-docker-sql.ps1: starts SQL Server in Docker
- restore-pt-docker-dbs.ps1: restores the databases and provisions
admin - start-pt-server.ps1: starts the login and game servers
- stop-pt-server.ps1: stops the server processes
- find-pt-item.ps1: looks up items by name, item code, or numeric item ID
- find-pt-map.ps1: looks up maps by name, short name, or map ID
- find-pt-monster.ps1: looks up monsters by name, monster ID, or model file
- patch-pt-client-localhost.ps1: patches the client runtime to localhost
- assign-pt-character-to-account.ps1: reassigns an existing character to a target account
- fix-pt-local-runtime.ps1: applies known local runtime fixes
- provision-pt-test-account.ps1: creates or updates a custom test account with GM permissions
- export-pt-reference-docs.ps1: regenerates the reference markdown files
Look up an item:
.\scripts\find-pt-item.ps1 -Search "WA101"
.\scripts\find-pt-item.ps1 -Search "stone axe"
.\scripts\find-pt-item.ps1 -Search "murky" -OldLook up a map:
.\scripts\find-pt-map.ps1 -Search "Ricarten"Look up a monster:
.\scripts\find-pt-monster.ps1 -Search "Kelvezu"Enable GM mode in-game:
/activategm
Main solution:
PristonTale.sln
Main code areas:
- client code in
game/ - server code in
Server/
This source was based on the fPT / rPT Source Code.
Thanks:
- Joao "Prog" Vitor (HiddenUserHere)
- Igor Segalla (Slave)
- Adolpho Pizzolio (HaDDeR)
- Gabriel "Rovug" Romanzini
- Leonardo "Lee" Souza