Quick Help: NetHack Helper is designed to be intuitive for NetHack players. If you're familiar with the game mechanics, most features should be self-explanatory!
🍖 Can I Eat This?
How does the food safety checker work?
Tap the floating food button (available from any screen) to open the food safety overlay:
- Search for any creature by name to check if its corpse is safe to eat
- Results are color-coded: green (safe), blue (beneficial), yellow (risky), red (dangerous)
- Tap a creature for detailed effect breakdowns including intrinsic grants and probabilities
What does the shield toggle do?
The shield icon toggles dynamic safety mode. When enabled, the safety ratings factor in your currently active resistances from the Intrinsics tab. For example, a corpse that grants poison resistance shows as "beneficial" if you don't have it yet, but "safe" if you already do. Disable the shield to see ratings assuming no resistances.
Can I access the food checker from the Intrinsics tab?
Yes! When viewing intrinsic source details, corpse entries have a link icon. Tap it to jump directly to that creature's eat info in the food safety overlay.
🏪 Price Identification Features
How does the price calculator work?
The price calculator uses NetHack's actual pricing formulas:
- Select your character's charisma level (3-25)
- Choose an item category (potions, scrolls, etc.)
- Compare shop prices to the calculated ranges
- Check off items as you identify them
The app calculates both buy and sell prices based on your charisma, just like in the game. Unidentified items also show generation weight probabilities to help you narrow down what an unknown item might be.
Why don't the prices match exactly?
NetHack prices can vary due to:
- Cursed items: Cost more than base price
- Blessed items: May have different pricing
- Shopkeeper mood: Angry shopkeepers charge more
- Tourist tax: Some shops charge tourists extra
The app shows base prices - actual shop prices may be higher due to these factors.
Can I add custom items?
Currently, the app includes all standard NetHack items. Custom items from variants or mods are not supported in this version.
🔮 Spell Calculator
How accurate are the spell success rates?
Very accurate! The formula used is:
(Intelligence + 4 + XPLevel/2 - SpellLevel*2) / 20
This matches NetHack's actual spell failure calculation. The app also accounts for skill level bonuses when available.
What do the 'S' and 'E' indicators mean?
These show spell skill enhancements:
- S: Skilled level bonuses
- E: Expert level bonuses
Long-press these indicators to see detailed descriptions of the enhanced effects.
Why can't I set Intelligence above 25?
While NetHack theoretically allows higher Intelligence, values above 25 provide no additional spell success benefit. The app focuses on practical gameplay ranges.
⚡ Intrinsics & Resistances
How do the expandable source details work?
Tap any intrinsic row to expand it and see all the ways to obtain that intrinsic:
- Items: Rings, amulets, armor, and artifacts that grant the intrinsic
- Innate: Role-based grants with the experience level they activate
- Corpses: Creatures whose corpses grant the intrinsic, with probability percentages
- Other: Miscellaneous sources like spells, genocide, or wishes
What happens when I add a new score?
The app automatically resets all tracking screens when you add a new score:
- All 19 intrinsic toggles reset to off
- Protection and prayer inputs clear
- Price calculator resets to default charisma
- All item identification selections are cleared
- Spellbook intelligence and XP level reset to defaults
- Sokoban progress resets to the beginning
This streamlines starting a new character without manual cleanup.
How do I find the hidden timeline chart?
Easter Egg: Triple-tap any score entry in the Scores tab to reveal an interactive timeline chart showing your progress over time!
Can I export my scores?
Your scores are stored in JSON format in your device's Documents directory. While there's no built-in export feature, you can access this data through iTunes file sharing or similar methods.
🧩 Sokoban Solution Viewer
How does the Sokoban viewer work?
The viewer provides step-by-step animated solutions for all 8 Sokoban puzzles (4 floors × 2 variants):
- Select a level (1a through 4b) from the button grid
- Use forward/back buttons or the slider to scrub through steps
- Each step shows an animated boulder push with the player moving simultaneously
- Consecutive same-direction pushes are merged into a single smooth animation
What are the ASCII and Tiles view modes?
Toggle between two rendering styles:
- ASCII: Classic black background with white characters, matching the traditional NetHack look
- Tiles: Uses the DawnHack tileset sprites for a graphical view
Your view preference is saved between sessions.
What do the symbols mean?
@— Your character0— Boulder^— Pit (trap)<>— Stairs up/down-|— Walls.— Floor
📱 App Usage
Does the app need internet access?
No! NetHack Helper works completely offline. All data is stored locally on your device, and no internet connection is required for any features.
Will my data sync between devices?
Currently, no. All data is stored locally on each device. This ensures privacy but means data doesn't transfer between devices.
How much storage does the app use?
Very little! The app itself is small, and your game data (scores, settings) typically uses less than 1MB even after extensive use.
🔧 Troubleshooting
The app crashes or behaves unexpectedly
Try these steps:
- Force-close and restart the app
- Restart your device
- Ensure you have the latest iOS version
- If issues persist, contact support
Some features seem slow or unresponsive
This usually indicates:
- Low device memory - close other apps
- Very old device - app is optimized for iOS 14+
- Corrupted data - try resetting app data
How do I reset all app data?
To completely reset the app:
- Delete all scores manually from the Scores tab
- Reset all intrinsics and settings to defaults
- Or delete and reinstall the app
Warning: This will permanently delete all your scores and settings.
💡 Tips & Tricks
Optimizing for gameplay
- Food Safety: Check corpses before eating - enable dynamic safety so ratings reflect your current resistances
- Price ID: Set your charisma before entering shops
- Intrinsics: Toggle them as you gain resistances, then expand to see what you still need
- Spells: Update Intelligence/XP when leveling up
- Scores: Add games immediately after death/ascension
- Sokoban: Step through the solution side-by-side with your game
Understanding NetHack mechanics
The app assumes familiarity with NetHack. For learning the game itself, we recommend:
- The official NetHack wiki
- NetHack community forums
- Guidebooks and tutorials
This app focuses on providing tools for players who already understand the mechanics.
📧 Still Need Help?
If your question isn't answered here, please contact us. We're always happy to help fellow NetHack players!