Help & Documentation

Everything you need to know about using Mythoscript

Quick Navigation

Getting Started

Creating a Character

To create your first character:

  1. Navigate to the Characters page
  2. Click "Create New Character"
  3. Choose your class, ancestry, and background
  4. Allocate ability scores using point-buy or standard array
  5. Save and start your adventure!

Joining a Campaign

To join an existing campaign:

  1. Get the Campaign Code from your DM
  2. On the Characters page, select your character
  3. Click "Join Campaign"
  4. Enter the campaign code and confirm
ℹ️

Campaign codes are case-sensitive. Ask your DM if you're having trouble.

Campaigns & DM Tools

For Dungeon Masters

As a DM, you have access to powerful campaign management tools:

  • Campaign Creation: Click "DM Tools" to create a new campaign
  • Invite Players: Share your campaign code with players to let them join
  • Party View: See all characters in your campaign at once
  • Market Control: Open/close the marketplace for your players

Running Encounters

The encounter system helps you track combat and distribute rewards:

  1. Go to your campaign's DM page
  2. Click "Start Encounter" on the Encounters tab
  3. Add party members by clicking their cards
  4. Click "Add Monsters" to open the Beastiary
  5. Search for creatures and set quantity
  6. Roll initiative for all combatants
  7. Track HP by clicking on each participant
  8. When combat ends, add loot and close the encounter
ℹ️

Initiative is automatically sorted highest to lowest. You can adjust values as needed.

Adding Loot & Rewards

During or after an encounter, you can distribute rewards to the party:

  • Gold/Currency: Enter amount and select coin type (pp, gp, sp, cp)
  • Items from List: Search the item database for weapons, armor, and gear
  • Magic Items: Add special magical equipment (coming soon: custom properties)
  • Custom Items: Add any item with a name, quantity, and notes
⚠️

When you close an encounter, ALL loot is distributed to ALL party members automatically. Make sure to review before closing!

Encounter History

View past encounters on the History tab:

  • See XP awarded, duration, and combatants
  • Review combat notes and loot distributed
  • Delete old encounters to clean up history
  • System keeps last 10 encounters automatically (FIFO)

Session Notes

Keep campaign notes organized:

  • Track NPCs met, plot hooks, and story threads
  • Free users: 2,000 character limit
  • Premium users: 4,000 character limit
  • Auto-saves as you type

Market Management

Control when and where players can shop:

  1. Go to the Marketplace tab on your DM page
  2. Toggle market status: Open or Closed
  3. Select which shops are available (General Store, Blacksmith, etc.)
  4. Players can only buy/sell when market is open
ℹ️

Close the market during dungeon crawls or when shops shouldn't be accessible!

Campaign Rewards & Loot

Viewing Your Rewards

After your DM closes an encounter, rewards appear on the Bag page:

  • Look for the "Recent Campaign Rewards" section at the top
  • Each encounter shows XP, coins, and items earned
  • Unclaimed rewards show a 💰 icon
  • Claimed rewards show a checkmark

Claiming Rewards

To receive your loot:

  1. Click on any unclaimed reward to expand details
  2. Review the XP, coins, and items you'll receive
  3. Click "🎁 Claim Rewards"
  4. Coins are added to your purse automatically
  5. Items are added to your bag automatically
  6. XP is added to your character (may trigger level up!)
ℹ️

Claiming is instant! Your coin purse and inventory update immediately.

Managing Reward History

Keep track of what you've claimed:

  • Claimed rewards are hidden by default to keep the feed clean
  • Click "Show Claimed Rewards" to view your history
  • See when you claimed each reward (timestamp shown)
  • Rewards cannot be unclaimed once processed

Understanding Loot Distribution

How loot works in Mythoscript:

  • Automatic Distribution: All party members receive the same loot
  • Gold Conversion: Currency is converted to coins in your purse
  • Item Handling: Equipment goes directly to your bag
  • Party Split: The rewards feed shows suggested splits for fairness
⚠️

Loot is distributed to ALL party members when the encounter closes. Coordinate with your party about who takes what!

Character Management

Leveling Up

When you gain enough XP to level up:

  1. A Level Up notification will appear
  2. Click to open the level-up modal
  3. Increase your hit points
  4. Select new class features or spells
  5. Apply Ability Score Improvements (ASI) when available

Equipment & Inventory

Manage your gear on the Equipment and Bag pages:

  • Equipment: Quick-slot weapons, armor, and accessories
  • Bag: View all items, manage quantities, and track encumbrance
  • Marketplace: Buy and sell items when the market is open
  • Swapping Equipment: When you equip a new weapon, the old one returns to your bag automatically
  • Campaign Rewards: Loot from encounters appears in the rewards feed
⚠️

Equipped items cannot be sold. Unequip them first in Equipment.

ℹ️

Your old weapon doesn't disappear! It goes back to your bag when you equip something new.

Spells & Spellcasting

For spellcasting classes:

  • Prepare spells on the Overview page
  • Track spell slots and cast spells during gameplay
  • Long rest to restore all spell slots
  • Some classes recover slots on short rest (check your class features)

Combat & Health

Tracking Hit Points

The Health page helps you manage combat:

  • Take Damage: Reduces current HP
  • Heal: Restores HP (cannot exceed max)
  • Temp HP: Temporary buffer that absorbs damage first
  • Short Rest: Roll hit dice to recover HP
  • Long Rest: Restore to full HP and recover hit dice

Death Saves

When your HP reaches 0:

  1. You fall unconscious and begin making death saves
  2. Roll a d20 each turn: 10+ is a success, 9 or lower is a failure
  3. Three successes: You stabilize
  4. Three failures: Your character dies
  5. Natural 20: Wake up with 1 HP
  6. Natural 1: Counts as two failures
⚠️

Taking damage while at 0 HP counts as a failed death save. Critical hits count as two failures!

Conditions

Track status effects on the Health page:

  • Blinded, Charmed, Deafened - Sensory impairments
  • Frightened, Grappled, Paralyzed - Movement restrictions
  • Poisoned, Restrained, Stunned - Combat penalties
  • Unconscious, Exhaustion - Severe debuffs

Marketplace & Economy

Buying Items

When your DM opens the market:

  1. Go to the Bag page
  2. Scroll to the Marketplace section
  3. Select a shop (General Store, Blacksmith, etc.)
  4. Click Buy to browse inventory
  5. Purchase items using your gold, silver, and copper
ℹ️

Prices are based on D&D 5e SRD. Items are added directly to your bag.

Selling Items

To sell items for gold:

  1. Ensure the marketplace is open
  2. On the Bag page, find the item you want to sell
  3. Click Sell
  4. Confirm the transaction
  5. Receive gold based on the item's value
⚠️

You cannot sell equipped items. Unequip them first!

Market States

Your DM controls marketplace access:

  • Open: All shops available, buy and sell freely
  • Closed: No transactions possible (wilderness, dungeons, etc.)
  • Limited: Only certain shops available (future feature)

Data & Privacy

Exporting Your Data

You can download all your character data at any time:

  1. Go to Settings
  2. Scroll to the Account section
  3. Click "Export Data"
  4. A JSON file will download with all your characters
ℹ️

Your export includes characters, equipment, spells, and progression history.

Account Management

Manage your Mythoscript account:

  • Change Password: Update your login credentials
  • View Last Login: See when you last signed in
  • Character Usage: Track how many characters you've created vs your plan limit
  • Delete Account: Permanently remove your account and all data

Read our full Privacy Policy for details.

Tips & Best Practices

General Tips

  • Save often: Changes sync automatically, but refresh if you see stale data
  • Encumbrance: Watch your carry capacity (STR × 15 lbs)
  • Starting kits: Apply your class kit on the Bag page for quick setup
  • Dice roller: Use the Dice page for quick rolls during gameplay
  • Mobile friendly: Mythoscript works great on phones and tablets

For Dungeon Masters

  • Campaign management: Create campaigns, track party, manage marketplace access
  • Encounter tracking: Add monsters from the beastiary, roll initiative, track HP
  • Loot distribution: Add gold, items, and magic gear that auto-distributes to party
  • Market control: Open/close shops and control when players can buy/sell
  • Session notes: Keep organized notes with up to 4,000 characters (premium)
  • History tracking: Review past encounters with XP, loot, and combat notes
  • Party view: See all characters in your campaign at once on the Party tab

Troubleshooting

Q: My character isn't loading

A: Try refreshing the page. If the issue persists, clear your browser cache or try a different browser.

Q: Items aren't appearing in my bag

A: Check that you completed the purchase/acquisition. Refresh the page to sync with the server.

Q: I can't join a campaign

A: Verify the campaign code is correct (case-sensitive). Make sure you're logged in and have a character selected.

Q: Spell slots aren't restoring

A: Make sure you're taking a long rest (not just short rest). Some classes have special slot recovery rules.

Q: My equipment isn't showing correct AC

A: Check that items are equipped in the right slots. Some armor has DEX modifiers that affect total AC.

Q: How do I export my data?

A: Go to Settings → Account section → Click 'Export Data' button. A JSON file with all your characters will download automatically.

Q: I claimed rewards but items aren't in my bag

A: Refresh the Bag page. Items should appear in your inventory after claiming. Check the bottom of your bag list - new items are added to the end.

Q: My old weapon disappeared when I equipped a new one

A: This was a bug that's been fixed! Your old weapon should now return to your bag automatically. If you lost items before the fix, contact support.

Q: How do I distribute loot to specific players?

A: Currently, loot is distributed equally to all party members. Coordinate with your party about who keeps what items. Trading features coming soon!

Q: The marketplace is closed - how do I buy items?

A: Your DM controls marketplace access. Ask them to open the market on their DM page. This simulates traveling to a town or finding merchants.

Q: Can I see what loot I've already claimed?

A: Yes! On the Bag page, click 'Show Claimed Rewards' in the Recent Campaign Rewards section to see your full reward history with timestamps.