- Home
- Skills
- APIs & Backend
- AffixRoll
Works with the AI Agents you already use
AffixRoll
Simulate and validate RPG item affix rolls with strict power caps and slot constraints.
Free
AffixRoll
Example session with this skill installed
Affix Roll for a "Steel Longsword" with two affixes: "Flaming" (prefix, heat group, weight 2, power 0.4) and "of Speed" (suffix, haste group, weight 5, power 0.3).
- Read your context and instructions
- Compiled the affixroll
- Generated the data export
I have processed the rolls for the Steel Longsword. The script verified that all constraints were met, including group exclusivity and the 1.0 power cap. The item identity remained stable throughout the 20-roll simulation.
AFFIX ROLL
Item: Steel Longsword
Seed: 1
Rolls: 20
Power cap: 1.0
GEAR
| Roll | Affixes | Power | Still the same item |
|---|---|---|---|
| 1 | Flaming, of Speed | 0.7 | Yes |
| 2 | of Speed | 0.3 | Yes |
| 3 | Flaming, of Speed | 0.7 | Yes |
| 4 | (None) | 0.0 | Yes |
| 5 | Flaming | 0.4 | Yes |
| 6 | Flaming, of Speed | 0.7 | Yes |
| 7 | of Speed | 0.3 | Yes |
| 8 | Flaming, of Speed | 0.7 | Yes |
| 9 | of Speed | 0.3 | Yes |
| 10 | Flaming, of Speed | 0.7 | Yes |
| 11 | (None) | 0.0 | Yes |
| 12 | Flaming, of Speed | 0.7 | Yes |
| 13 | of Speed | 0.3 | Yes |
| 14 | of Speed | 0.3 | Yes |
| 15 | Flaming | 0.4 | Yes |
| 16 | Flaming, of Speed | 0.7 | Yes |
| 17 | of Speed | 0.3 | Yes |
| 18 | Flaming, of Speed | 0.7 | Yes |
| 19 | of Speed | 0.3 | Yes |
| 20 | Flaming, of Speed | 0.7 | Yes |
HITS
| Affix | Slot | Group | Hits |
|---|---|---|---|
| Flaming | prefix | heat | 12 |
| of Speed | suffix | haste | 15 |
EXCLUSIVE
None
CHECK
Second item: no
Over power: no
Next steps
- Review
affixes.csvto see the final hit counts for your balancing spreadsheet. - Use
roller.jsonas the input payload for your game engine's equipment manager. - Run the roll again with a different seed if you need to simulate a different RNG outcome.
Files: affix-log.md, affixes.csv, roller.json
affixes.csv
CSV · data export
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
Manual balancing of item affixes often leads to power creep or unintended stat stacking. This skill automates the gear-rolling process for RPG developers by strictly enforcing slot constraints and power caps. It ensures that a single item identity remains consistent across multiple iterations while preventing illegal mod combinations.
What it does
- Enforces slot logic by restricting affixes to specific prefix or suffix locations.
- Prevents group stacking so that two modifiers from the same category cannot be applied to one item.
- Calculates power totals and halts the roll if the cumulative power exceeds a predefined 1.0 threshold.
- Generates project-ready files including a structured CSV for data, a JSON configuration for external scripts, and a markdown log.
- Simulates 20-roll sequences to provide a clear hit-rate distribution for specific affixes.
How it works
- Identify the base item and the pool of available affixes from the developer's prompt or project files.
- Execute the roll logic via a Python script that processes the JSON-encoded item data and affix weights.
- Verify constraints to ensure no second item was created and no power caps were breached.
- Export the results by overwriting the local project files with the updated gear state and simulation data.
Frameworks & tools
The skill relies on a python3 environment to execute scripts/roll.py. It outputs data in JSON, CSV, and Markdown formats.
Why this beats prompting it yourself
Generic LLM prompts often hallucinate new item names or accidentally stack incompatible stats. This skill uses a strict logic gate to ensure item identity never changes and math-heavy constraints like power caps are handled by code, not probabilistic text generation.
Use cases
- Testing the hit rates of specific gear affixes during RPG balancing.
- Generating a consistent item state for a save file or database entry.
- Validating that a complex set of modifiers does not exceed a game's power budget.
Known limitations
Requires a local scripts/roll.py file to be present. It only supports one item per run and does not handle loot tables or rarity tiers.
Requires scripts/roll.py to exist. Limited to 20 rolls per execution. Supports a maximum of four affixes per item. Does not handle loot tables or pity systems.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
This skill has been used 5 times.
Trust & safety
Security scan
Security scan passed 29 days ago
- Free with an Agensi account
Permissions
No special permissions declared or detected