No description

Find a file

WiseDev ca8e41c2c5 roll chest loot from the csv instead of a fixed config RandomSpells / DifferentSpells / RareChance / EpicChance / MinGold / MaxGold all come off the chest row now, gold is scaled by the player's arena. magic chest is 30 cards over 8 cards with 1 epic and 6 rares, like the client says it is. arena chest rows inherit everything through BaseChest, so Free_Arena1 reads Free.		2026-08-23 09:30:38 +03:00
assets	initial import, client gets to the lobby	2026-08-23 07:50:31 +03:00
config	generate the daily card shop server side	2026-08-23 08:47:55 +03:00
crates	roll chest loot from the csv instead of a fixed config	2026-08-23 09:30:38 +03:00
.gitignore	nuke the tests and the dead code	2026-08-23 07:51:04 +03:00
Cargo.lock	move players and accounts into postgres	2026-08-23 08:40:13 +03:00
Cargo.toml	move players and accounts into postgres	2026-08-23 08:40:13 +03:00
LICENSE	add MIT license	2026-08-23 09:13:19 +03:00
README.md	initial import, client gets to the lobby	2026-08-23 07:50:31 +03:00

README.md

scroll-server

A server for the scroll client (Clash Royale 2.0.1306, iOS). Takes a real client from TCP connect to the lobby: login, own home data, chests, card upgrades, the shop.

Requirements

Rust 1.75+
PostgreSQL 16

Running

createdb scroll

cargo run --release -p scroll-server

Listens on 0.0.0.0:9339, the port the client hardcodes. The schema is created on first boot. DATABASE_URL defaults to postgres:///scroll.

On macOS a Homebrew cluster may need LC_ALL=C to start at all.

Services can also run separately:

cargo run --release -p auth-service
cargo run --release -p game-service
cargo run --release -p gateway

Checking it without a phone

scroll-probe speaks the same protocol and prints the decoded lobby:

cargo run --release -p gateway --bin scroll-probe -- 127.0.0.1:9339

Flags: --claim-free-chest, --buy-chest <name>, --desync. Pass an account and pass token to reconnect as an existing player: scroll-probe 127.0.0.1:9339 0 1 <passtoken>.

Pointing a client at it

The client hardcodes game.clashroyaleapp.com. Patch that string in the binary inside the ipa to your machine's address, keeping the 23 byte slot NUL padded so nothing around it moves.

Configuration

variable	default
`DATABASE_URL`	`postgres:///scroll`
`SCROLL_GATEWAY_LISTEN`	`0.0.0.0:9339`
`SCROLL_CSV_ROOT`	`assets`
`SCROLL_SHOP`	`config/shop.json`
`SCROLL_STARTER_PROFILE`	built in
`RUST_LOG`	`info`

Shop

config/shop.json lists what the server sells, as Name#count:

{
  "offers": [
    { "id": 1, "give": "Gold#1000" },
    { "id": 5, "give": "chest:Gold#1" },
    { "id": 7, "give": "Diamonds#500", "cost": "Gold#20000" }
  ]
}

Names resolve against the csv tables. cost is optional; without it the server charges the same price the client computes from the game data.