{"id":19877504,"url":"https://github.com/bbrtj/hackathon-gold-rush","last_synced_at":"2025-08-10T16:43:24.344Z","repository":{"id":42238847,"uuid":"213149275","full_name":"bbrtj/hackathon-gold-rush","owner":"bbrtj","description":"A game server for a hackathon-like event","archived":false,"fork":false,"pushed_at":"2023-04-24T19:31:35.000Z","size":1154,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-04T03:08:38.842Z","etag":null,"topics":["bot","game-server","hackathon","hackaton","tycoon"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bbrtj.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,"zenodo":null}},"created_at":"2019-10-06T10:35:22.000Z","updated_at":"2022-02-14T12:21:47.000Z","dependencies_parsed_at":"2025-06-06T20:16:13.400Z","dependency_job_id":null,"html_url":"https://github.com/bbrtj/hackathon-gold-rush","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bbrtj/hackathon-gold-rush","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbrtj%2Fhackathon-gold-rush","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbrtj%2Fhackathon-gold-rush/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbrtj%2Fhackathon-gold-rush/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbrtj%2Fhackathon-gold-rush/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbrtj","download_url":"https://codeload.github.com/bbrtj/hackathon-gold-rush/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbrtj%2Fhackathon-gold-rush/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269755635,"owners_count":24470538,"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-08-10T02:00:08.965Z","response_time":71,"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":["bot","game-server","hackathon","hackaton","tycoon"],"created_at":"2024-11-12T16:37:38.215Z","updated_at":"2025-08-10T16:43:24.307Z","avatar_url":"https://github.com/bbrtj.png","language":"Perl","readme":"A game server for a hackathon-like event\n===========\n\n### Name\n\nGold Rush - mine gold and grow your empire!\n\n![scores](https://raw.githubusercontent.com/brtastic/hackathon-gold-rush/assets/scores.png)\n\n### Description\n\nThis is a Perl web game server that requires players to write programs in any\nlanguage that interact with it in a certain way. The game requires strategy and\nimprovisation, as some events occur randomly and has to be taken into account.\nYour task is to build settlements, explore land, recruit units and gain as much\ngold as possible. A person with the highest amount of gold after a given number\nof turns win.\n\n*Problem type:* optimize the process, take randomness into account.\n\n*Required technical skills:* able to use HTTP APIs and WebSocket connections.\n\n*Recommended skill level:* Intermediate. Likely too hard for beginners to have\nfun.\n\n*Recommended solving time:* no less than three hours for one person, as this is\nthe time it took the author to write the reference perl bot implementation.\nSince the goal is not a simple matter of solving a puzzle, it can be back and\nforth battle who has the better algorithm with live preview of current leaders.\n\n### Player instructions\n\nSee instructions/lang.pod for game reference. Can do it in\ncommand line with command: `pod2text instructions/lang.pod`.\n\n### Existing implementations\n\nThe `examples` directory contains approaches to playing the game.\nCaution: _SPOILERS_\n\n### Running (with Docker)\n\n`docker-compose up`\n\n### Running (without Docker)\n\n*Note: perl 5.28 with Carton required. Carton is a Perl module dependency\nmanager. You will need to have it installed prior to the script below: cpan\nCarton*\n\n```\ncarton install                              # install the dependencies\ncarton exec prove -l                        # test the installation\ncarton exec plackup -p 5000 -D runner.psgi  # daemonize the game server\ncarton exec ./websocket prefork             # run the websocket server\n```\n\n### Scores\n\nAfter playing the game, a `scores` directory will contain scores for players. A\nscores file contains a single JSON document, with game state for every 10\nrounds.  The file is only present after the player has finished the game. A new\nscore will override the last one.\n\nTo view scores interactively, go to `address:5000/scores.html`\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbrtj%2Fhackathon-gold-rush","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbrtj%2Fhackathon-gold-rush","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbrtj%2Fhackathon-gold-rush/lists"}