{"id":31179428,"url":"https://github.com/toxicfrog/mercs-ap","last_synced_at":"2025-09-19T15:19:53.960Z","repository":{"id":315336374,"uuid":"1059083064","full_name":"ToxicFrog/mercs-ap","owner":"ToxicFrog","description":"Archipelago randomizer for Mercenaries: Playground of Destruction for PS2","archived":false,"fork":false,"pushed_at":"2025-09-18T01:23:14.000Z","size":768,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-18T03:30:54.746Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ToxicFrog.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-18T01:18:53.000Z","updated_at":"2025-09-18T01:23:17.000Z","dependencies_parsed_at":"2025-09-18T03:30:55.932Z","dependency_job_id":"5285f7f8-c337-47c5-87b0-24a64eb73657","html_url":"https://github.com/ToxicFrog/mercs-ap","commit_stats":null,"previous_names":["toxicfrog/mercs-ap"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ToxicFrog/mercs-ap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxicFrog%2Fmercs-ap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxicFrog%2Fmercs-ap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxicFrog%2Fmercs-ap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxicFrog%2Fmercs-ap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ToxicFrog","download_url":"https://codeload.github.com/ToxicFrog/mercs-ap/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxicFrog%2Fmercs-ap/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275958295,"owners_count":25559736,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-19T02:00:09.700Z","response_time":108,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-19T15:19:50.796Z","updated_at":"2025-09-19T15:19:53.950Z","avatar_url":"https://github.com/ToxicFrog.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mercenaries Archipelago\n\nThis is an [Archipelago Multiworld Randomizer](https://archipelago.gg) for the\nPS2 game *Mercenaries: Playground of Destruction*.\n\n## Features\n\n### Checks\n\nCompleting missions and verifying members of the Deck of 52 will count as AP\nchecks. Collecting bounties will also produce checks, with the number of\nbounties needed per check configurable in the yaml.\n\nIn all cases, the vanilla monetary and faction rewards are left intact; the AP\ncheck replaces the shop unlock or Ace intel you would normally get.\n\nMissable checks (most non-Ace cards and missions) will be auto-released at the\nend of their corresponding chapter, so rushing for the Ace early once you have\nenough intel and firepower is a viable strategy and will not lock you out of\nchapter-specific checks.\n\n### Items\n\n#### Progression\n\n**Ace intel.** This serves the same purpose as intel in the vanilla game.\nDepending on your yaml settings, it can use the vanilla intel amounts or a fixed\nnumber of \"intel tokens\" per ace, and it can be suited or progressive.\n\n**Merchant of Menace unlocks.** These are the only way to unlock new things in the store. You can enable duplicates in the item pool, in which case picking up duplicate unlocks will give you a permanent discount on that item.\n\n#### Filler\n\n**Cash bonuses.** These range from $5k to $500k.\n\n**Faction mood adjustments.** The more of these you have for a faction, the higher their minimum mood towards you is. There are diminishing returns as you collect more.\n\n**Shop discounts.** These range from 10% to 30% off. They are permanent and are automatically applied to whatever your most expensive item is. As you get more expensive items the coupons will automatically be moved around.\n\n**Free samples.** These apply to broad categories (e.g. \"free airstrike\") and will pick an appropriate random item from that category when issued to you. If you don't have at least three items in that category, they'll wait until you do. These samples are usually lost when you do anything involving a loading screen, so use it or lose it.\n\n### Hints\n\nCompleting a mission that gives in-game hints about the location of a Number\nwill also give an AP hint for what item that Number is carrying.\n\nCapturing a Card alive will give you a hint for a random progression item,\neither someone else's in your world, or one of yours in someone else's world.\n\n\n## Setup\n\n### Prerequisites\n\n- [Archipelago](https://archipelago.gg)\n- The [apworld](./release/mercenaries.apworld)\n- A **US** copy of \"Mercenaries: Playground of Destruction\", with game ID `SLUS-20932`\n- [PCSX2](https://pcsx2.net/) to play it with\n  - Real hardware not supported, sorry\n\nNote that this **is** compatible with iso and memory patches like the subtitles\npatch, widescreen, texture replacement, etc, as long as the base game is the\nUS version.\n\n### First-time setup\n\nGet PCSX2 installed and running and make sure you can actually run Mercenaries\nin it. Once you have that, change the following settings:\n- `Tools -\u003e Show Advanced Settings` **on**\n- `System -\u003e Settings -\u003e Advanced -\u003e PINE Settings -\u003e Enable` **on**\n- `System -\u003e Settings -\u003e Advanced -\u003e PINE Settings -\u003e Slot` **28011** (should be the default)\n\nIf your computer is sufficiently powerful, you may also want to open up\n`Settings -\u003e Game Properties -\u003e Emulation` and set the `EE Cycle Rate` to 180%\nor 300%; this will mess up the inter-chapter cutscenes, but allow the game to\nmaintain a steady 30fps during gameplay.\n\n### Per-game setup\n\nConfiguration and generation works basically the same as any other AP game; see\nthe generated YAML for options. To join, just click `Mercenaries Client` in the\nAP launcher and it should automatically connect to PCSX2.\n\n\n## Known Issues and Limitations\n\nCard verifications may not be registered by AP until the next time you open your\nPDA in-game.\n\nMessages and some items can only be delivered to Mercenaries at certain points\nin execution, which means there may be a significant delay between getting\nsomething in AP and it showing up in-game. This is particularly the case with\nmoney, intel, and faction reputation adjustments. Wandering around the game and\ndoing things to force it to load/unload areas and NPCs tends to speed up this\nprocess.\n\nCombat logic only takes into account how many things you have unlocked, not what\nthings, e.g. it will not lock a mission where you fight helicopters behind\nhaving access to anti-air support. Missions generally give you everything you\nneed on-site if you look around, so this is not a problem in practice.\n\nWindows and OSX should work, but are completely untested.\n\n## Future Work\n\nSome of these are speculative, and depend on reverse engineering I haven't done\nyet to figure out if they're viable; this is a wishlist, not a roadmap.\n\n- New checks:\n  - Mission bonus objectives\n  - Challenges\n  - Vehicles driven/destroyed catalogue entries\n- New items:\n  - Character skins\n  - Health/ammo/grenade capacity upgrades\n  - Health/ammo/grenade refills\n- Improved logic:\n  - Better mission logic, e.g. missions that want anti-air depending on having\n    an AA vehicle, supply drop, or airstrike unlocked\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxicfrog%2Fmercs-ap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoxicfrog%2Fmercs-ap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxicfrog%2Fmercs-ap/lists"}