Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Ecoscrolls rearranged #67

Merged
merged 6 commits into from
Jul 17, 2024
Merged

Ecoscrolls rearranged #67

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
4a4df3b
rearranged to make sense
Exanthiax Jul 17, 2024
d9362ba
Merge branch 'ecoscrolls' of https://github.com/Exanthiax/auxilor.git…
Exanthiax Jul 17, 2024
86472f6
Update how-to-make-a-scroll.md
Exanthiax Jul 17, 2024
1542521
Update how-to-make-a-scroll.md
Exanthiax Jul 17, 2024
b292525
extra tweaks
Exanthiax Jul 17, 2024
dbfadd7
Update the-item-lookup-system.md
Exanthiax Jul 17, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 9 additions & 8 deletions docs/all-plugins/the-item-lookup-system.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,16 +65,17 @@ So, lets say you have an EcoMobs mob, and you want it to drop a rare custom weap
## Using items from my other plugins
You can use items from my other plugins anywhere using The Item Lookup system.

| Plugin | Item Lookup Key |
|------------------|---------------------------------------------------------------------------------------------------------------------|
| EcoItems | `ecoitems:<id>` |
| Talismans | `talismans:<id>` |
| EcoMobs | `ecomobs:<id>_spawn_egg` |
| EcoPets | `ecopets:<id>_spawn_egg` |
| StatTrackers | `stattrackers:<id>` |
| Plugin | Item Lookup Key |
| ------------ | ------------------------------------------------------------------------------------------------------------------- |
| EcoArmor | `ecoarmor:set_<set>_<slot>` (Optional: `_advanced`) <br/>`ecoarmor:shard_<set>`<br/>`ecoarmor:upgrade_crystal_<id>` |
| EcoCrates | `ecocrates:<crate>_key` |
| EcoItems | `ecoitems:<id>` |
| EcoMobs | `ecomobs:<id>_spawn_egg` |
| EcoPets | `ecopets:<id>_spawn_egg` |
| EcoScrolls | `ecoscrolls:scroll_<id>` |
| Reforges | `reforges:stone_<id>` |
| EcoArmor | `ecoarmor:set_<set>_<slot>` (Optional: `_advanced`) <br/>`ecoarmor:shard_<set>`<br/>`ecoarmor:upgrade_crystal_<id>` |
| StatTrackers | `stattrackers:<id>` |
| Talismans | `talismans:<id>` |

## Using items in MythicMobs
If you want to use a lookup item in MythicMobs, just do it like this: `eco{type=<lookup_key>}`, e.g. `eco{type=ecoitems:<id>}`
Expand Down
2 changes: 1 addition & 1 deletion docs/ecoitems/commands-and-permissions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar_position: 3
## `/ecoitems give` (Give players items)
Permission: `ecoitems.commands.give`

General Usage: `/ecoitemsgive <player> <item> [amount]`
General Usage: `/ecoitems give <player> <item> [amount]`

For example, if you wanted to give a player a reaper scythe, you would do: `/ecoitems give <player> reaper_scythe`

Expand Down
114 changes: 46 additions & 68 deletions docs/ecoscrolls/how-to-make-a-scroll.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,77 +22,24 @@ ID's must be lowercase letters, numbers, and underscores only.
# including in subfolders if you want to organize your scroll configs
# _example.yml is not loaded.

# The name of the scroll
name: "&6Example Scroll"

# The max level of the scroll
max-level: 1

# The amount of times the scroll can be used
max-uses: 1

# Options for the physical scroll item
item:
item: paper glint

# Name and lore can use %uses%, %max_uses%, and %uses_left% placeholders
name: "&6&lExample Scroll"
lore:
- "&7This is an example scroll."
- "&7It does nothing."

# Options for crafting, read here: https://plugins.auxilor.io/all-plugins/the-item-lookup-system#crafting-recipes
craftable: false
recipe: [ ]

# Options for inscribing items with the scroll
inscription:
# The conditions required to inscribe the item
# not-met-effects will run if someone tries to inscribe the item without meeting the conditions
conditions: [ ]

# The effects that will be run when the item is inscribed
# If your scroll works by modifying the item (e.g. adding enchantments, changing durability),
# then put those effects here.
effects: [ ]

# Read https://plugins.auxilor.io/all-plugins/prices
# The price to inscribe the item
price:
value: 100
type: coins
display: "&e%value% coins"

# The formula to multiply the price depending on the level.
# The %level% placeholder is the *current* level of the scroll
price-level-multiplier: "1 + %level% * 0.5"

# If the scroll can be applied to items via drag-and-drop
drag-and-drop: true

# If the scroll can be applied to items via the inscription table
inscription-table: true
name: "&6Example Scroll" # The name of the scroll
lore: # The lore added to items when inscribed with the scroll
- ""
- "&7This item has been inscribed with"
- "&6Example Scroll"

# The items that the scroll can be applied to, see targets.yml
targets:
targets: # The items that the scroll can be applied to, see targets.yml
- sword

# The conflicts that the scroll has with other scrolls
conflicts: [ ]
conflicts: [ ] # The conflicts that the scroll has with other scrolls

# The scroll(s) that must be applied to the item before this scroll can be applied
requirements:
- scroll: my_requirement_scroll # The scroll to require
- scroll: my_requirement_scroll # The ID of scroll to require
level: 2 # The level required (optional)
remove-requirements: false # If inscribing this scroll should remove the required scrolls

# If inscribing this scroll should remove the required scrolls
remove-requirements: false

# The lore added to items when inscribed with the scroll
lore:
- ""
- "&7This item has been inscribed with"
- "&6Example Scroll"
max-level: 1 # The max level of the scroll
max-uses: 1 # The amount of times the scroll can be used

# Item placeholders for dynamic lore in plugins like EcoItems
# The placeholder is %ecoscrolls_scroll_<scroll>:<placeholder>%, e.g.
Expand All @@ -113,6 +60,41 @@ effects:
# The conditions for the scroll to work
conditions: [ ]

# Options for the physical scroll item
item:
item: paper glint
# Name and lore can use %uses%, %max_uses%, and %uses_left% placeholders
name: "&6&lExample Scroll"
lore:
- "&7This is an example scroll."
- "&7It does nothing."
craftable: false
recipe: [ ]

# Options for inscribing items with the scroll
inscription:
inscription-table: true # If the scroll can be applied to items via the inscription table
drag-and-drop: true # If the scroll can be applied to items via drag-and-drop

# Read https://plugins.auxilor.io/all-plugins/prices
# The price to inscribe the item
price:
value: 100
type: coins
display: "&e%value% coins"

# The formula to multiply the price depending on the level.
# The %level% placeholder is the *current* level of the scroll
price-level-multiplier: "1 + %level% * 0.5"

# The conditions required to inscribe the item
# not-met-effects will run if someone tries to inscribe the item without meeting the conditions
conditions: [ ]

# The effects that will be run when the item is inscribed
# If your scroll works by modifying the item (e.g. adding enchantments, changing durability),
# then put those effects here.
effects: [ ]
```

## Understanding all the sections
Expand Down Expand Up @@ -140,10 +122,6 @@ requirements:

**placeholders:** Dynamic custom placeholders to show in the lore of other items (`%ecoscrolls_scroll_<scroll>_<placeholder>%`).

**effects:** Effects for the scroll to give. See [Effects & Conditions](https://plugins.auxilor.io/ecoscrolls/how-to-make-a-custom-scrollt#effects--conditions)

**conditions:** Conditions for the scroll to work. See [Effects & Conditions](https://plugins.auxilor.io/ecoscrolls/how-to-make-a-custom-scrollt#effects--conditions)

### Effects & Conditions

The effects section is the core functionality of the EcoScroll. You can configure effects, conditions, filters, mutators and triggers in this section to run whilst the inscribed item is held or used.
Expand Down
4 changes: 2 additions & 2 deletions docs/effects/all-triggers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ and are used in plugins like EcoSkills, EcoPets, EcoJobs (etc) for levelling.
| `heal` | Triggered when regaining health | The health regained |
| `hold_item` | Triggered when changing your held item | 1 |
| `hook_in_ground` | Triggered when a fishing rod hook hits the ground | 1 |
| `inscribe` | Triggered when inscribing a scroll **Requires EcoScrolls** | 1 |
| `item_break` | Triggered when breaking any item in your inventory (durability) | 1 |
| `jobs_level_up` | Triggered when levelling up a job **Requires Jobs Reborn** | The new level |
| `join` | Triggered when joining the server | 1 |
Expand Down Expand Up @@ -120,7 +121,6 @@ and are used in plugins like EcoSkills, EcoPets, EcoJobs (etc) for levelling.
| `toggle_sneak` | Triggered when changing the sneak state | 1 |
| `toggle_sprint` | Triggered when changing the sprint state | 1 |
| `trident_attack` | Triggered on injuring an entity with a thrown trident **Requires Paper** | The damage dealt |
| `try_inscribe` | Triggered when attempting to inscribe a scroll **Requires EcoScrolls** | 1 |
| `villager_trade` | Triggered when trading with a villager **Requires Paper** | The experience the villager gains |
| `win_raid` | Triggered when a player wins a raid | The level of bad omen |
| `inscribe` | Triggered when inscribing a scroll **Requires EcoScrolls** | 1 |
| `try_inscribe` | Triggered when attempting to inscribe a scroll **Requires EcoScrolls** | 1 |
Loading