{"id":13823349,"url":"https://github.com/aerth/rpg","last_synced_at":"2025-07-08T17:33:31.866Z","repository":{"id":44361321,"uuid":"94168915","full_name":"aerth/rpg","owner":"aerth","description":"OpenGL cross platform topdown 2d magic action rpg game single player arpg","archived":false,"fork":false,"pushed_at":"2022-07-09T16:48:09.000Z","size":4270,"stargazers_count":26,"open_issues_count":0,"forks_count":5,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-05T09:11:50.901Z","etag":null,"topics":["2d","2d-game","arpg","game","game2d","hack-and-slash","opengl","pixel","rpg","top-down"],"latest_commit_sha":null,"homepage":"https://aerth.itch.io/aerpg","language":"Go","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/aerth.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}},"created_at":"2017-06-13T04:27:47.000Z","updated_at":"2024-06-20T22:12:01.000Z","dependencies_parsed_at":"2022-09-06T23:12:14.429Z","dependency_job_id":null,"html_url":"https://github.com/aerth/rpg","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerth%2Frpg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerth%2Frpg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerth%2Frpg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerth%2Frpg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aerth","download_url":"https://codeload.github.com/aerth/rpg/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225453325,"owners_count":17476701,"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":["2d","2d-game","arpg","game","game2d","hack-and-slash","opengl","pixel","rpg","top-down"],"created_at":"2024-08-04T09:00:31.397Z","updated_at":"2024-11-20T01:30:30.254Z","avatar_url":"https://github.com/aerth.png","language":"Go","funding_links":["https://www.paypal.me/aerth"],"categories":["Go"],"sub_categories":[],"readme":"lets make a game\n\n2D, top-down, pixelized magic action RPG\n\ncontributions very welcome (see roadmap)\n\n# [AERPG](https://github.com/aerth/rpg)\n\n**demo**\n\n\n[![Build Status](https://travis-ci.org/aerth/rpg.svg?branch=master)](https://travis-ci.org/aerth/rpg)\n\n![screenshot](https://raw.githubusercontent.com/aerth/rpg/master/doc/screenshot.png)\n\n## INCLUDED TOOLS\n\n  * aerpg - play the demo rpg: explore map, kill skeletons, pick up loot, gain xp, collect magic items\n\n  * mapmaker - create/edit a map:  read source code for keymap  \n\n  * mapgen - generate a map: run `mapgen ______` to use specific seed such as `mapgen mycoolseed`\n\n## FETCHING DEPENDENCIES\n\n  * install Go: [go](https://golang.org)\n\n  * install C dependencies: `apt-get install xorg-dev libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev libopenal-dev libasound2-dev`\n\n  * fetch this source code and dependencies: `go get -v -d -u github.com/aerth/rpg/cmd/...`\n\n## INSTALLING AERPG GAME\n\n### Requirements\n\nIf you're using Windows and having trouble building Pixel, please check [this\nguide](https://github.com/faiface/pixel/wiki/Building-Pixel-on-Windows) on the\n[wiki](https://github.com/faiface/pixel/wiki).\n\n[PixelGL](https://godoc.org/github.com/faiface/pixel/pixelgl) backend uses OpenGL to render\ngraphics. Because of that, OpenGL development libraries are needed for compilation. The dependencies\nare same as for [GLFW](https://github.com/go-gl/glfw).\n\nThe OpenGL version used is **OpenGL 3.3**.\n\n- On macOS, you need Xcode or Command Line Tools for Xcode (`xcode-select --install`) for required\n  headers and libraries.\n- On Ubuntu/Debian-like Linux distributions, you need `libgl1-mesa-dev` and `xorg-dev` packages.\n- On CentOS/Fedora-like Linux distributions, you need `libX11-devel libXcursor-devel libXrandr-devel\n  libXinerama-devel mesa-libGL-devel libXi-devel` packages.\n- See [here](http://www.glfw.org/docs/latest/compile.html#compile_deps) for full details.\n\n**The combination of Go 1.8, macOS and latest XCode seems to be problematic** as mentioned in issue\n[#7](https://github.com/faiface/pixel/issues/7). This issue is probably not related to Pixel.\n**Upgrading to Go 1.8.1 fixes the issue.**\n\n### Compiling\n\n```go get -v -d github.com/aerth/rpg```\n```GOBIN=$PWD go install github.com/aerth/rpg/cmd/...```\n\n## keymap:\n\n  * Pause, Inventory, Char Stats: `i`\n  \n  * Movement: `arrows`, `asdw`, `hjkl`, `hold right mouse`\n\n  * Zoom: `mouse wheel`\n\n  * Identify tile: `left click`\n\n  * Pick up loot: `left click`\n\n  * Attack (manastorm): `space` `middle click`\n\n  * Attack (magic bullet): `B` `left click (point/shoot)`\n\n  * Quit: ctrl+Q\n\n## CHEATS\n\n  * Toggle show enemy paths: `=`\n\n  * Toggle fly mode: `caps lock`\n\n  * Mana potion: `1`\n\n  * Health potion: `2`\n\n  * XP potion: `3`\n\n  * Speed up time: `LSHIFT`\n\n  * Slow motion: `TAB`\n\n  * Random Loot: `ctrl+L` (random location), `ctrl+K` (under mouse)\n\n  * Spawn fresh mob: `M` (watch FPS go down)\n\n## ROADMAP\n\n  * [ ] Regions (separated by doors)\n\n  * [ ] Doors/Portals connect regions\n\n  * [ ] Spawn tiles (instead of random tile) (should be Rectangle)\n\n  * [ ] Map editor improvements (toolbar, pallet, fix offsets)\n \n  * [ ] Text boxes (space to speed past conversations, pgup pgdown scroll)\n  \n  * [ ] Text Input (cheat codes, debug, chat, user input)\n\n  * [x] Pick up loot\n\n  * [ ] Drop item\n\n  * [ ] proper Inventory and Wearing\n\n  * [ ] Optimization\n\n  * [ ] Replace spritesheets, allow texturepacks, skins\n\n  * [ ] \"Stage 1\" map and missions, villages with markets, npcs, enemies, and a generated dungeon with bad guys and a boss\n\n  * [ ] D2 style multiplayer co-operative and chat (no p2p)\n\n\n### questions / support / donations\n\ndonations support the author and will make more frequent updates\n\nBTC: ![https://blockchain.info/address/1ANjiTNvdEM6Me3yc4EBFSkDb4db4XW6pr](https://blockchain.info/qr?data=1ANjiTNvdEM6Me3yc4EBFSkDb4db4XW6pr\u0026size=200)\n\nPayPal Me: https://www.paypal.me/aerth\n\nquestions and comments can be directed to the email address published at https://github.com/aerth\n\n\n### credits\n\n  * font 'Admtas' by [adem taş](http://www.dafont.com/profile.php?user=980017)\n  * font '[Terminus TTF Font](http://files.ax86.net/terminus-ttf/)' (SIL Open Font License, version 1.1)\n  * [sprite generator](http://gaurav.munjal.us/Universal-LPC-Spritesheet-Character-Generator/)\n  * [main character sprite](http://mmorpgmakerxb.com/p/characters-sprites-generator)\n  * big thanks to the [pixel](https://github.com/faiface/pixel) library\n  * additional credits in `assets/sprites/credits.txt` file\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faerth%2Frpg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faerth%2Frpg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faerth%2Frpg/lists"}