ProLibertateGames/docs/RE-catan-universe.md

Catan Universe 2.7.5 — what the reverse engineering showed

Source: Catan+Universe_2.7.5_APKPure.xapk (Unity, IL2CPP). Method: the Unity scenes (level3 is the match scene) were parsed with UnityPy for the uGUI hierarchy (names, anchors, sizes, which objects start hidden), and global-metadata.dat was searched for class, method and game-action names. Code bodies were not decompiled; behaviour below that is not visible in a hierarchy is marked inferred.

The game is landscape-only; the canvas is laid out against a 1920×1080 reference.

Match HUD (InGameUI_mobile)

Region	Contents
Top	PlayerFrames: one frame per player (avatar, colour, VP, card count, timer), a "shuffle stats" button at the right
Bottom bar	ResourceContainer, centred (anchors 25–75 % of the width, 90 px tall): one entry per resource (Lumber, Brick, Wool, Grain, Ore; Cloth, Coins, Paper for C&K; Fish, Feather, Coca for other expansions, hidden otherwise)
Bottom right	BtnTurn (140 px, roll / end turn), BtnTrade immediately to its left (counter-offer and "blocked" badge variants), BtnAddDevCard, a chat/log BubblePanel
Left edge	Drag&DropBuild: a column of piece icons. The player drags a piece from it onto the board (Drag&DropBuildRemove is the drop target that cancels)
Mid right	ConfirmButtonGroup: a ✓ (CatanConfirmBuildButton) over a ✗ (CatanCancelBuildButton). A drop only previews; the ✓ commits
Board	CandidateFactory makes highlight markers for every legal spot (corner, edge, face); QuickBuildTrigger{Corner,Edge,Face} are hit zones for a one-tap/hold build; a candidate ticker shows the one-line instruction
Centre	Played-card panel, progress-card chooser, discard panel (CardPanel slides up over the bottom bar with a header)

Gestures (CatanGestureHandler, BaseGesture, TapHoldHandler): one finger pans the board, two-finger pinch zooms (GetPinchZoomMagnitude, AutomaticZoom), tap selects a candidate, hold opens quick-build. Camera is a fixed-pitch table view.

Trade board (TradeBoard_mobile)

A full-width panel that slides up over the bottom of the screen (Animator, collapsible):

┌────────────────────────────────────────────────────────────┬──────┐
│ [Player] [Bank]   headline / description     ☐ Block trade │ P1 P2│ header
├────────────────────────────────────────────────────────────┤ P3 P4│ (135 px)
│ OPPONENT row  — cards you get (tinted by the opponent's    │      │
│                 colour)                                    │ Hide │
│        ⇣⇣⇣  arrows  (or the bank ratio chips 4:1 3:1 2:1)  │ Deny │
│ PLAYER row    — cards you give (tinted by your colour)     │Accept│
└────────────────────────────────────────────────────────────┴──────┘

• Header. A Player / Bank toggle (extra toggles for the Inka 3:2 / 2:1 rules). A Block trade checkbox refuses all incoming offers. One round button per rival (Player1…5, with a selected border) picks whom the offer is addressed to; none selected means everyone.
• Content. Two rows of resource cards separated by arrows. The top row is what you want, the bottom row what you give. Tapping a card in a row adds one; tapping a selected card removes one (inferred from AddFieldToTradePayment/ApplyCancelTradeResource). In Bank mode a ratio row (CardRatios) shows the best rate per resource (harbours).
• Right column (180 px). Hide/collapse, Deny (✗), Accept (✓). When you are the one receiving an offer, ✓ accepts and the chip-icon variant Icon_CounterOffer turns the ✓ into a counter-offer send. A circular turn timer wraps the ✓.
• Incoming offers (IncomingTradeContainer) show in the same panel; the offerer's colour tints the opponent row. Counter-offers land back in the proposer's panel with an AcceptCounterOfferButtonImage.

Seafarers game actions (from the metadata)

CatanSeafarer_*_GameAction names show what the mode adds to the base game:

• Ships: BuildShip, MoveShip (only the ship at the open end of a route, not on the turn it was built), BuildFreeRoad; roads and ships share AvailableCandidatesRoadAndShip.
• Pirate alongside the robber: RobberPirat_Move, RobberPirat_SelectPlayer; ships cannot be built or moved past a pirate-blocked edge.
• Gold fields: ChooseGoldfieldResource (a hex that pays any resource of choice).
• Fog islands: Check_FogField, DistributeFogField (hidden hex revealed when a road/ship reaches it, the player takes the resource), Shuffle_Islands, Shuffle_TileValueList.
• Treasure islands / Oasis / Great Canal are Catan Universe scenario extras and are not part of the physical Seafarers rules. Names and texts only (rule values are compiled code): TreasureRule with chest outcomes (bricks, wool, grain; a resource; a development card; two roads), SeafarerOasis (no rule class of its own, base-game rules), and GreatCanalRule with BuildCanal, CanalVictoryPoints, "The canal was completely dug. Now grain can be grown." and a target of 21 / 18 points. The base-game scenario baseharbormaster: "2 victory points. This card goes to the first player to acquire at least 3 harbors. If another player acquires more, he will immediately receive this card." Implemented as inferred rules; see docs/RULES-catan-seafarers.md.
• Setup: StartPhase_BuildSettlement, StartPhase_BuildRoadShip, PlaceValueChip (number tokens placed per scenario), Shuffle_Harbors.
• Island bonus: special victory points for the first settlement on a new island (AllIslandIds, CatanIslandState).