{"id":21231185,"url":"https://github.com/clemlak/vanquish-contracts","last_synced_at":"2025-03-15T02:21:59.785Z","repository":{"id":101905875,"uuid":"455182851","full_name":"clemlak/vanquish-contracts","owner":"clemlak","description":null,"archived":false,"fork":false,"pushed_at":"2022-02-03T15:12:17.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-21T18:15:51.844Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Solidity","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/clemlak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2022-02-03T13:49:04.000Z","updated_at":"2022-02-03T14:48:39.000Z","dependencies_parsed_at":"2023-04-29T11:47:30.309Z","dependency_job_id":null,"html_url":"https://github.com/clemlak/vanquish-contracts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clemlak%2Fvanquish-contracts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clemlak%2Fvanquish-contracts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clemlak%2Fvanquish-contracts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clemlak%2Fvanquish-contracts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clemlak","download_url":"https://codeload.github.com/clemlak/vanquish-contracts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243672823,"owners_count":20328819,"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","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":"2024-11-20T23:41:15.548Z","updated_at":"2025-03-15T02:21:59.757Z","avatar_url":"https://github.com/clemlak.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⚔️ Vanquish\n\nOn-chain strategy game mixing \"Play-to-Earn\" and DeFi on Ethereum.\n\n**DISCLAIMER: This game is currently a prototype!**\n\n## 🔖 Overview\n\nVanquish is a strategy game running on the Ethereum blockchain, inspired by board and mobile games such as Risk or Antiyoy. In a nutshell, the concept is:\n- 🚩 Claim lands to collect resources\n- 🪖 Use resources to buy units (soldiers)\n- ⚔️ Defeat your opponents to steal their loot\n\nOn top of that, the game features some elements such as:\n- 💰 Actual token prizes when defeating your opponents\n- 🙏 No-loss defeats thanks to interests-based loots\n- 🗺 *Almost* infinite map\n- ⏳ *Semi-real-time* gameplay to balance real players and bots\n\n## 📖 Rules\n\nThe game contains 5 actions that players can execute. Each action starts a 30 seconds cooldown, allowing an equitable gameplay between real players and bots.\n\n### 👶 Spawn\n\nFirst thing to do is to pick a land to spawn and start your journey:\n- Your spawn land must not contain any resources\n- It must not be currently owned by an opponent\n- Can be anywhere on the map, between -2^256 and 2^256 on both x and y axes\n\nNeedless to say, but spawning can only happen once.\n\n*Note: In the future, spawning will require to stake tokens to generate your loot. The staked tokens will be locked during your game, but will be entirely recoverable, even if you end up defeated!*\n\n### 🚩 Claim\n\nClaiming is one of the biggest part of the gameplay: it consists in taking ownership of a land and its resources. Most of the lands will be empty, but some of them will contain resources that can be used later to buy units (soldiers).\n\nClaiming a land is free, the only requirement is that the new land is directly next to a land you currently own.\n\n### 💎 Buy\n\nSome lands contain resources that you can collect and use to buy units. You can buy as much units as you want at the same time, and they will be delivered directly to your spawn land.\n\n### 🚍 Move\n\nUnits can be moved from a land to another freely, but once again only if both lands are side by side.\n\n### ⚔️ Attack\n\nPvP is the other big chunk of gameplay, but the whole thing is pretty straightforward:\n- Attacking an opponent requires to have side by side lands\n- Attacking with more units will defeat your opponent and will grant you the ownership of their land\n- Losing will simply slay your units and will leave your land defenseless\n\nConquering the spawn land of an opponent will vanquish him and will grant you their loot.\n\n## 🕹 How to play\n\nSince the game doesn't have an interface (yet), the easiest way to try it out is directly via [Etherscan](https://rinkeby.etherscan.io/address/0x594d80FCeCc11eed63d80749E03A7109e383B8E7#writeContract):\n- Start by calling the `spawn` function to create your base. You can check if the land you want is available by using the `getLand` function (returned value should be `0`)\n- Then expand your empire using `claim`, you simply have to pass the coordinates of the land you want to claim along with the coordinates of a bordering land that you own\n- If you are lucky you'll collect resources, don't forget to spend them to `buy` units!\n- Feel free to `move` your units depending on your strategy: are you going to reinforce your base or push your borders?\n- If you are feeling bellicose, you might want to `attack` your opponents, but be careful if they have allies...\n\n## 🚀 Deployments\n\n| Network | Address |\n|---|---|\n| Rinkeby | [0x594d80FCeCc11eed63d80749E03A7109e383B8E7](https://rinkeby.etherscan.io/address/0x594d80FCeCc11eed63d80749E03A7109e383B8E7) |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclemlak%2Fvanquish-contracts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclemlak%2Fvanquish-contracts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclemlak%2Fvanquish-contracts/lists"}