{"id":51519907,"url":"https://github.com/robthepcguy/gunk-dev","last_synced_at":"2026-07-08T15:00:50.839Z","repository":{"id":370019176,"uuid":"1289536465","full_name":"RobThePCGuy/Gunk-dev","owner":"RobThePCGuy","description":null,"archived":false,"fork":false,"pushed_at":"2026-07-07T23:09:05.000Z","size":45,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-07-08T00:14:33.610Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Lua","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/RobThePCGuy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-04T22:04:38.000Z","updated_at":"2026-07-07T23:09:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/RobThePCGuy/Gunk-dev","commit_stats":null,"previous_names":["robthepcguy/gunk-dev"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/RobThePCGuy/Gunk-dev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FGunk-dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FGunk-dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FGunk-dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FGunk-dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RobThePCGuy","download_url":"https://codeload.github.com/RobThePCGuy/Gunk-dev/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FGunk-dev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35268549,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"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":"2026-07-08T15:00:49.891Z","updated_at":"2026-07-08T15:00:50.831Z","avatar_url":"https://github.com/RobThePCGuy.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gunk: the sewer slime that follows you home\n\n\u003e Everything in the Noxious Sewers wants you dead. **Gunk** just wants to come along.\n\nA fan-made companion mod for [Ancient Dungeon VR](https://store.steampowered.com/app/1125400/Ancient_Dungeon_VR/)\n(by ErThu), built on the game's official Lua modding API. Not affiliated with or endorsed by ErThu.\n\n---\n\n## Who is Gunk?\n\nGunk is the runt of the Noxious Sewers: too small to threaten anyone, too filthy to be worth the boot. Find him\non a New Game Plus run and he imprints on the first delver who doesn't squish him. Take his relic and he's yours\nfor the run: bouncing at your heel, hurling his whole tiny body at anything hostile, and hitting harder as *you*\nhit harder (his damage is carved off your own).\n\nBut the deeper you go, the more his homeland wants him back. At **NG++** the sewers reclaim him. Permanently,\nand visibly. His skin darkens into the sewers' own festering rot, and the harmless headbutt becomes a mouthful of\nacid: slow, fat globs lobbed in a lazy arc that burn where they land and keep burning after. Same little slime.\nMuch worse manners. *(Prefer him one way or the other? The \"Spitter Form\" setting can force or forbid the\ncorruption.)*\n\n## Features\n\n- **A real companion, not a turret.** He hops around like any slime, pounces on nearby enemies, body-slams\n  them, and bounces back to your side like nothing happened.\n- **Scales with you.** His hits draw on your live primary + secondary damage. Upgrade yourself and you've\n  upgraded him.\n- **Unkillable.** The dungeon has tried. Nothing puts Gunk down, so the chaos of a deep run never costs you\n  your buddy.\n- **Earned, not handed out.** He only appears at New Game Plus, a reward for going back down.\n- **A story with a cost.** At NG++ his home corrupts him into the Spitter, for good. He announces the change\n  himself, both ways.\n- **An honest artillery slime.** Spitter globs are real projectiles on a smooth arc. Damage lands where the\n  glob lands: dodgeable, splashy, and every impact leaves an acid puddle. He even winds up before each lob and\n  settles after, like he means it.\n- **Tune him in the headset.** Damage, movement, spit behavior, unlock rules: every knob is a row of one-tap\n  presets under **Settings → Mods → Gunk**, applying live within seconds. Works on Quest and PCVR, no file\n  editing.\n- **Survives everything, including you quitting.** Leave mid-run and continue later, and his relic re-drops at\n  your feet when the save loads, whatever floor you're on.\n\n## Mod settings\n\nOpen **Settings → Mods → Gunk** in-game. Every setting is a row of notched presets. The selected option is\nalways visible, the panel re-opens on whatever you chose, and changes apply live (within ~2 s):\n\n| Setting | Options | Default | What it does |\n| --- | --- | --- | --- |\n| Damage | 20 / 40 / 80 / 150 % | 40 % | Gunk's hit = (your Primary + Secondary damage) × this |\n| Hop Height | 100 / 130 / 180 / 250 % | 130 % | Base hop height |\n| Attack Hop | 100 / 130 / 180 / 250 % | 130 % | Extra pounce height while hunting an enemy (100 % = none) |\n| Move Speed | 80 / 106 / 130 / 160 % | 106 % | Hop movement speed |\n| Hunt Range | 4 / 6 / 8 / 10 m | 6 m | He redirects onto hostiles within this radius |\n| Leash | 8 / 12 / 16 / 20 m | 12 m | Past this from you he despawns and respawns at your side |\n| Spit Cooldown | 2 / 3.6 / 5 / 8 s | 3.6 s | Time between spits in Spitter form |\n| Spit Speed | 3 / 5 / 8 / 12 m/s | 5 m/s | Glob flight speed (lower = slower, lazier lobs) |\n| Spit Range | 5 / 8 / 10 / 12 m | 8 m | He spits at visible hostiles within this radius |\n| Spit Splash | 0.8 / 1.2 / 1.6 / 2.0 m | 1.2 m | Impact damage radius where the glob actually lands |\n| Appears At | NG+ / Any Run | NG+ | Require New Game Plus (the intended unlock), or let Gunk appear on regular runs too |\n| Spitter Form | At NG++ / Always / Never | At NG++ | The story rule (corrupted at NG++), force the acid-spitter everywhere, or keep him melee forever. Switches live, even mid-run |\n| Teaser Delay | 1 / 2 / 3 / 5 s | 2 s | How long after the relic drops the teaser text appears |\n\nThe leash always stays at least 2 m longer than the hunt range. Otherwise he could chase prey straight out of\nhis own leash and despawn mid-pounce, which is embarrassing for everyone.\n\n## How to get Gunk\n\n1. Reach **New Game Plus**. *(Or set \"Appears At\" to **Any Run** and skip the grind.)*\n2. Descend into the **Noxious Sewers**. Something small tumbles into the muck nearby.\n3. **Pick up the relic** to recruit him for the rest of the run. Leave it, and he waits in the muck. He's used\n   to waiting.\n4. Reach **NG++** and the sewers take him back: corrupted, and spitting.\n\n## Install\n\nDownload the latest `Gunk.zip` from the Releases page (or Nexus Mods, rename it if needed) and **keep it zipped**: the game reads\nthe zip directly.\n\n### PCVR (Steam / Rift)\n\n1. First, enable mods to set up the proper folder structure. Launch the game in VR, and in the settings menu on the right, you’ll see a box that enables mods when clicked. Then you can exit the game.\n2. Drop **Gunk.zip** into `%USERPROFILE%\\AppData\\LocalLow\\ErThu\\Ancient_Dungeon\\ADVR_Mods\\` *(paste that straight into the File Explorer address bar - AppData is a hidden folder)*.\n3. Launch the game in VR and enable the mod in the in-game **mods menu**.\n\n### Quest (standalone headset)\n\n1. **In the headset:** start Ancient Dungeon, open **Settings**, and press the **enable modding** button. Grant\n   the **Read External Storage** permission when the prompt appears. The game reloads, and you can close it\n   after.\n2. Connect the Quest to a computer with a USB cable and **allow file access** (approve the prompt inside the\n   headset). Browse the Quest's storage with Windows Explorer, SideQuest, or Android File Transfer on Mac.\n3. Navigate to `/sdcard/Android/data/de.erthu.ancientdungeonfull/files/ADVR_Mods/`.\n4. Copy `Gunk.zip` into that folder, unplug, launch the game, and enable the mod in the in-game **mods menu**.\n\n**Mod version:** 1.0.0 (see [CHANGELOG.md](CHANGELOG.md)) · **Game version:** built and tested against `ea0.1.10.1`.\n\n## Known interactions\n\n- **A Walk in the Park** (Acolyte upgrade): the game's own \"no enemies within 13 m\" check counts Gunk as a\n  nearby enemy, which would silently disable the perk's speed boost for as long as he's with you. The mod\n  compensates: when Gunk is the only \"enemy\" in the perk's radius, it applies the same boost itself — same\n  +20 % cap, same ramp speed — and drops it the moment a real hostile closes in. You keep the perk you paid\n  for. *(In co-op, the compensation follows whoever carries the relic.)*\n- Gunk's hits are attributed to the player's secondary damage (the same mechanism vanilla relics like Vicious\n  Barb use), so on-hit effects can trigger from his attacks.\n- Multiplayer: the relic and companion are untested in co-op. `supportedInMultiplayer` is set, and the design is\n  co-op-aware, but treat it as experimental.\n\n## For developers\n\nThe mod is plain Lua + a manifest. To build and deploy locally (Windows, PowerShell):\n\n```powershell\n./deploy.ps1\n```\n\nThis zips the `Gunk/` folder and copies `Gunk.zip` into your `ADVR_Mods` folder. The script refuses to build if any\n`.lua` contains a semicolon (the ADVR linter rejects them). Source layout:\n\n```\nGunk/\n  mod.modinfo                              # mod manifest\n  settings.lua                             # in-game settings panel (Settings -\u003e Mods -\u003e Gunk)\n  items/gunk/gunk.lua                      # the companion relic (all per-tick logic)\n  progress_shops/acolyte/gunk_watcher.lua  # the swamp detector: drops the relic on fresh AND resumed runs\n```\n\nWhy a progress-shop script for the detector: it is the only always-on mod content type whose `onGlobalTick` fires\non *resumed* (continued) runs. Achievements only receive world callbacks on runs started fresh from the home\nbase. It registers as a small \"Gunk's Watcher\" node in the Acolyte's insight shop; it works identically whether\nor not it is ever bought.\n\n## License\n\nReleased under the [MIT License](LICENSE): free to use, fork, and learn from, as long as the copyright notice is\nkept. *Ancient Dungeon VR* and its assets remain the property of ErThu.\n\n## Credits\n\n- **Ancient Dungeon VR** by ErThu, the game this mod extends.\n- Mod by [RobThePCGuy](https://github.com/RobThePCGuy).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthepcguy%2Fgunk-dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobthepcguy%2Fgunk-dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthepcguy%2Fgunk-dev/lists"}