{"id":41193909,"url":"https://github.com/daiimus/gelatinous","last_synced_at":"2026-01-22T20:31:40.832Z","repository":{"id":309988662,"uuid":"603620353","full_name":"daiimus/gelatinous","owner":"daiimus","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-26T04:43:12.000Z","size":5462,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-11-28T11:55:14.193Z","etag":null,"topics":["evennia","ihavenoideawhatimdoing","mud"],"latest_commit_sha":null,"homepage":"https://gelatinous.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daiimus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2023-02-19T04:07:12.000Z","updated_at":"2025-11-26T04:43:16.000Z","dependencies_parsed_at":"2025-08-30T04:15:53.988Z","dependency_job_id":"90a68b53-4377-40cd-ad52-76914ef6b1be","html_url":"https://github.com/daiimus/gelatinous","commit_stats":null,"previous_names":["daiimus/gelatinous"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/daiimus/gelatinous","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daiimus%2Fgelatinous","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daiimus%2Fgelatinous/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daiimus%2Fgelatinous/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daiimus%2Fgelatinous/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daiimus","download_url":"https://codeload.github.com/daiimus/gelatinous/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daiimus%2Fgelatinous/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28670381,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T19:36:09.361Z","status":"ssl_error","status_checked_at":"2026-01-22T19:36:05.567Z","response_time":144,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["evennia","ihavenoideawhatimdoing","mud"],"created_at":"2026-01-22T20:31:40.760Z","updated_at":"2026-01-22T20:31:40.819Z","avatar_url":"https://github.com/daiimus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gelatinous\n\nA text-based multiplayer game built on the [Evennia](https://www.evennia.com/) MUD framework. Gelatinous implements a tactical turn-based combat system with proximity mechanics, grappling, medical trauma simulation, and messaging systems designed to prioritize storytelling.\n\n**Live Instance**: [https://gel.monster](https://gel.monster)  \n**Telnet**: play.gel.monster:23\n\n## Overview\n\nGelatinous is a pre-alpha MUD (Multi-User Dungeon) that explores tactical combat design with a focus on narrative depth. The game features the G.R.I.M. system (Grit, Resonance, Intellect, Motorics) - a four-attribute framework governing character capabilities in combat, social interactions, and skill resolution.\n\n### Core Features\n\n- **Turn-Based Tactical Combat**: Initiative-driven combat system with 6-second rounds\n- **Proximity System**: Melee/ranged positioning with tactical movement commands (advance, retreat, charge, flee)\n- **Grappling Mechanics**: Multi-participant restraint system with contested rolls, dragging, and human shield functionality\n- **Medical Simulation**: Wound tracking, bleeding mechanics, pain management, and recovery systems\n- **Projectile Physics**: Cross-room throwing with flight timing, trajectory calculation, and interception mechanics\n- **Environmental Interaction**: Trap rigging, graffiti system, crowd dynamics, and weather effects\n- **Equipment Systems**: Layered clothing with armor values, weapon wielding, and inventory consolidation\n- **Shop System**: Prototype-based shops with infinite/limited inventory and merchant NPCs\n- **Death \u0026 Corpses**: Death progression system with forensic corpses and decay mechanics\n- **Object Interaction**: Wrest command for contested item acquisition, frisk for searching\n- **Consumption System**: Eating, drinking, and substance effects\n- **Bug Reporting**: In-game bug reporting command\n- **Natural Language Processing**: Ordinal number recognition and flexible command parsing\n- **Atmospheric Messaging**: 95+ weapon-specific message templates with three-perspective combat narration\n\n### G.R.I.M. Attribute System\n\n- **Grit**: Physical toughness, endurance, and raw strength\n- **Resonance**: Social awareness, empathy, and interpersonal skills\n- **Intellect**: Mental acuity, tactical thinking, and problem-solving\n- **Motorics**: Physical coordination, dexterity, and reflexes\n\nThese attributes drive contested rolls, skill checks, and combat resolution throughout the game.\n\n## Quick Start\n\n**Connect**: [https://gel.monster](https://gel.monster) or `telnet play.gel.monster 23`\n\n**Local Development**: Requires [Evennia](https://www.evennia.com/docs/latest/Setup/Installation.html). Standard `evennia migrate` and `evennia start` workflow. (Gelatinous does currently make extensive use of a channel called Splattercast which requires manual creation at this time.)\n\n## For Developers\n\n### Architecture Overview\n\nThe codebase follows Evennia's standard structure with custom extensions for combat, medical, and environmental systems:\n\n```\ngelatinous/\n├── commands/          # Command implementations\n│   ├── combat/       # Combat commands (attack, grapple, flee, aim, etc.)\n│   ├── CmdInventory.py   # Wield, get, drop, give, wrest, frisk\n│   ├── CmdCharacter.py   # Character sheet and stats\n│   ├── CmdThrow.py       # Projectile throwing\n│   ├── CmdMedical.py     # Medical treatment commands\n│   ├── CmdMedicalItems.py # Medical item management\n│   ├── CmdClothing.py    # Clothing and armor\n│   ├── CmdArmor.py       # Armor-specific commands\n│   ├── CmdConsumption.py # Eating and drinking\n│   ├── CmdGraffiti.py    # Environmental writing\n│   ├── CmdSpawnMob.py    # NPC spawning (admin)\n│   ├── CmdBug.py         # Bug reporting\n│   ├── shop.py           # Shop interaction commands\n│   └── charcreate.py     # Character creation menu\n├── typeclasses/      # Game object definitions\n│   ├── objects.py         # Base object with ordinal number support\n│   ├── characters.py      # Character typeclass with G.R.I.M. stats\n│   ├── items.py           # Weapons, armor, consumables\n│   ├── rooms.py           # Room features and environmental systems\n│   ├── corpse.py          # Corpse with forensic data and decay\n│   ├── shopkeeper.py      # Shop containers and merchants\n│   ├── death_progression.py # Death state management\n│   └── exits.py           # Custom exit functionality\n├── world/            # Game systems and handlers\n│   ├── combat/       # Combat system modules\n│   │   ├── handler.py     # CombatHandler script\n│   │   ├── constants.py   # System constants\n│   │   ├── messages/      # 95+ weapon-specific message templates\n│   │   ├── proximity.py   # Tactical positioning\n│   │   ├── grappling.py   # Restraint mechanics\n│   │   └── utils.py       # Utility functions\n│   ├── medical/      # Medical trauma simulation\n│   │   ├── core.py        # Medical state management\n│   │   ├── conditions.py  # Status effects and wounds\n│   │   ├── script.py      # Automated processes (bleeding, healing)\n│   │   ├── constants.py   # Medical system constants\n│   │   └── wounds/        # Wound type definitions\n│   ├── shop/         # Shop system\n│   │   └── utils.py       # Shop pricing and inventory\n│   ├── utils/        # Shared utilities\n│   │   └── boxtable.py    # Table formatting\n│   ├── crowd/        # Crowd simulation\n│   └── weather/      # Weather and environmental effects\n├── server/           # Evennia configuration\n│   └── conf/         # Game settings\n├── specs/            # Design documents and specifications\n└── docs/             # Project documentation\n```\n\n### Key Systems\n\n**Combat**: Turn-based Script-driven handler with initiative order, opposed rolls, and 6-second rounds. See [`AGENTS.md`](AGENTS.md) for comprehensive architecture.\n\n**Proximity**: Tactical positioning distinguishing melee/ranged engagement with movement commands (advance, retreat, charge, flee).\n\n**Grappling**: Multi-participant restraint with contested rolls, dragging, takeover mechanics, and human shield functionality.\n\n**Medical**: Wound severity tracking, bleeding accumulation, pain effects, and treatment requirements.\n\n**Messages**: 95+ weapon-specific templates with three-perspective narration (attacker, victim, observer) and dynamic content loading.\n\n**Death \u0026 Corpses**: Death progression system managing unconsciousness, death state, and corpse creation with forensic data preservation and just-in-time decay calculations.\n\n**Shops**: Prototype-based shop system supporting infinite/limited inventory, dynamic pricing with markup, and merchant NPC integration.\n\n## Documentation\n\n- **[AGENTS.md](AGENTS.md)** - Combat system architecture and patterns\n- **[ARCHITECTURE.md](ARCHITECTURE.md)** - Project structure overview\n- **[PROJECT_OVERVIEW.md](PROJECT_OVERVIEW.md)** - Design philosophy\n- **[specs/](specs/)** - 20+ detailed specifications for implemented and planned features\n\n## Project Status\n\n**Current Phase**: Pre-Alpha Development\n\n### Implemented Systems\n\n- ✅ Turn-based combat with initiative\n- ✅ G.R.I.M. attribute system\n- ✅ Proximity and tactical positioning\n- ✅ Multi-participant grappling with contests\n- ✅ Medical trauma and wound tracking\n- ✅ Cross-room throwing mechanics\n- ✅ Equipment and clothing systems with armor\n- ✅ Shop system with prototype-based inventory\n- ✅ Death progression and corpse forensics\n- ✅ Object wresting and contested acquisition\n- ✅ Consumption system (eating/drinking)\n- ✅ Medical item management system\n- ✅ Bug reporting system\n- ✅ Natural language command parsing\n- ✅ Atmospheric combat messaging (95+ templates)\n- ✅ Environmental systems (graffiti, crowds, weather)\n- ✅ Character creation menu system\n\n### In Development\n\n- 🚧 Additional weapon types and combat moves\n- 🚧 Expanded medical conditions and treatments\n- 🚧 Economic systems and trade\n- 🚧 Quest and narrative frameworks\n- 🚧 Character progression systems\n\n### Planned Features\n\nSee `specs/` directory for 20+ detailed specifications of planned expansions including advanced environmental interactions, crafting systems, social mechanics, and faction systems.\n\n## Contributing\n\nPersonal project in active development. Open an issue or visit the game to discuss contributions.\n\n## Built With\n\n[Evennia](https://www.evennia.com/) - Python MUD/MU* framework | [Documentation](https://www.evennia.com/docs/latest/) | [GitHub](https://github.com/evennia/evennia)\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaiimus%2Fgelatinous","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaiimus%2Fgelatinous","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaiimus%2Fgelatinous/lists"}