⚔ MMOItems

Give, take, count and track MMOItems items in your TypeWriter quests.

A TypeWriter extension by BTC Studio

✨ What it does

You pick an item by its MMOItems type (for example SWORD) and id. The panel suggests types and ids from the MMOItems configuration of your server, so you do not type them blind. Matching ignores case, an empty type and id means any MMOItems item, and items from other plugins never match.

The extension also ships an Advanced Tooltip System that rewrites MMOItems lore on the fly, as packets sent to the player. The stored item is never changed.

🎒 Rewards and requests

• 
  
• Give items: hand out MMOItems items to one player or a whole group, from a list or from a fact.
• Take items: remove items from the inventory (armor, off hand and cursor included) and/or the main hand, for a quest that asks the player to hand something over.
• Count items: a fact counts matching items in the inventory and/or the main hand, so a dialogue can check what the player carries.
• Item possession objective: complete when the player holds enough of the items listed in a count fact, with completion modifiers.
• Item variable: use an MMOItems item anywhere TypeWriter expects an item.
• Crafting table: open a crafting table for the player from an action, and count it as an objective.

🔨 React to what players do

• 
  
• Use: right-clicking or consuming an MMOItems item fires an event or counts toward an objective.
• Craft: items made in an MMOItems station fire an event or count toward an objective, with an optional filter on the station.
• Equip: count MMOItems armor pieces put on in an armor slot.
• Gem stones: react when a gem stone is applied to an item, filtered by target item and gem.
• Ability casts: count how many times a player casts an MMOItems ability.
• Persistent progress: objectives store their progress in a persistent fact and trigger onComplete once when the amount is reached.

📖 Advanced tooltips

• 
  
• Several pages per item: split a long lore with a <page_break> tag. A key switches pages (default F) and pages wrap back to the first.
• Live requirement marks: <requirement_met> and <requirement_not_met> show a symbol of your choice. With MMOCore, they check level, class, profession level and permission.
• Stat comparison: press the comparison key (default sneak) on an item to set it as the base, then see the stat difference on items of the same type, with a + when positive.
• Category icons and indicators: an icon per item type and indicators for the page and the comparison.
• Everything configurable: keys, symbols, icons and indicators are fields of one entry in the web panel.
• Survival and Adventure only: in Creative the client sends items back as it shows them, so the original lore is left untouched.

🎨 Quest tracker display

The line of each objective in the quest tracker is read from TypeWriter snippets, not from the code. Restyle the in-progress and completed lines with the <display>, <current> and <required> placeholders.

🧩 Entries

Entries (16)

Actions

• 
  
• give_mmoitem_action: give MMOItems items to a player or a group
• remove_mmoitem_action: take MMOItems items from the inventory and/or hand
• open_crafting_table_action: open a crafting table for the player

Events

• 
  
• use_mmoitem_event: an MMOItems item is right-clicked or consumed
• mmoitems_item_craft_event: an item is crafted in an MMOItems station (optional station filter)
• mmoitems_gem_stone_apply_event: a gem stone is applied to an item

Objectives

• 
  
• mmoitems_count_objective: hold enough of the items listed in a count fact
• use_mmoitem_objective: use MMOItems items
• mmoitems_item_craft_objective: craft MMOItems items
• mmoitems_item_equip_objective: equip MMOItems armor
• mmoitems_gem_stone_apply_objective: apply gem stones
• mmoitems_ability_cast_objective: cast MMOItems abilities
• open_crafting_table_objective: open a crafting table

Facts

• 
  
• mmoitems_count_fact: count MMOItems in the inventory or hand

Variables

• 
  
• mmoitem_variable: use an MMOItems item anywhere an item is expected

Tooltips

• 
  
• advanced_tooltip_config: pages, keybinds, requirement marks, comparison tags, category icons, lore override on or off

🚀 Set up

• 
  
• Install MMOItems and MythicLib, plus the TypeWriter Quest extension. Drop the jar in plugins/Typewriter/extensions/ and restart.
• On a sequence page, add a Give MMOItem action: set the item type, the id and the amount.
• On a static page, add a Craft Objective with a persistent fact and the crafted item, and link the Give action in onComplete.
• For tooltips, add an Advanced Tooltip System entry on a manifest page, add the tags to your item lore, and publish.

📋 Requirements

• 
  
• TypeWriter 0.9.0-beta-177 or newer, with the Quest extension
• Paper 1.21+ server
• MMOItems (built against 6.9.3) and MythicLib (1.6.2)
• Advanced tooltips use PacketEvents, included with TypeWriter 0.9
• Optional: MMOCore (1.12.1), to check class, level and professions in the requirement marks