Skip to content

Latest commit

 

History

History
200 lines (164 loc) · 9.85 KB

cmi-worth.md

File metadata and controls

200 lines (164 loc) · 9.85 KB

FAQ - How can I use CMI's Worth Feature?

FAQ Menu

• CMI and Bungeecord info-, • Chance example, • CMI Chat manager, • Chat format info, • Chat filter, • Chat rooms, • CMI Commands info, • Custom Join and Leave, • CMI Economy manager, • Event commands, • Extending commands, • Getting started with CMI, • Glow info, • Create custom /help, • CMI Hex colors, • Importing data into CMI, • CMILib library info, • Customizing CMI Locale, • CMI Chat with LuckPerms prefix, • Migrate to MySQL database, • Player stuck in Mode?, • User-moderation info, • More message commands, • MOTD, • Parameters explained, • Ranks info, • Create custom /rules, • Running CMI, • Safety tips, • Specialized commands info, • Toggle example, • Trash example, • CMI Vote manager, • Worth info.

Official Zrips Links
  • Zrips Website 
    https://www.zrips.net/
    The official website, wiki/documentation/information
  • Zrips Discord 
    https://discord.gg/dDMamN4
    The official Discord community server with member-driven support
  • Zrips Github 
    https://github.com/Zrips
    The place for bug reports and feature suggestions
Prerequisites
  • Buy and Download CMI (premium plugin) 
    https://www.spigotmc.org/resources/3742/
    Get the CMI plugin if you haven't already, and then install it on all your servers
  • Also Download CMILib (free library) (more info) 
    https://www.spigotmc.org/resources/87610/
    All Zrips plugins require the CMILib .jar file. Get it and also put it on all your servers.
  • All my FAQ pages have been written for Spigot / Paper 1.20.x and CMI 9.6.x.x or newer.
  • The mrfdev Github page is not an official resource, we're building up our knowledge base as a courtesy.
  • I am an admin on the Zrips Discord, this does not mean what I share on here is official.

You can use CMI as economy manager, using /sell, players can sell items if the value is known in the worth.yml file. You can manage the values ingame, you can even see what items are missing, and auto generate worth values if the raw material value is known. You combination of dynamic signs, holograms, and interactive commands, can all be used to show dynamic values, balance top, etc.

The worth.yml file can be found in the ~/plugins/CMI/Saves/worth.yml location.

ℹ️ CMI Worth Feature

Commands and Permissions:

/cmi generateworth
-> cmi.command.generateworth - Auto generate possible item worth values

/cmi sell (all/blocks/hand/same/gui/material)
-> cmi.command.sell.[blocks/hand] - Allows to sell items not only from your hand
-> cmi.command.sell - Sell items from inventory

/cmi setenchantworth
-> cmi.command.setenchantworth - Change enchantment worth

/cmi setworth (itemname) -s:(sellPrice)
-> cmi.command.setworth - Change item worth

/cmi worth (all/blocks/hand/material)
-> cmi.command.worth - Check item worth

/cmi worthlist (playerName) (-missing)
-> cmi.command.worthlist - Check list of items with set sell prices
-> cmi.command.worthlist.others - Check list of items with set sell prices

Placeholders:

%cmi_iteminhand_worth%
%cmi_iteminhand_worth_one%
%cmi_iteminhand_worthc%
%cmi_iteminhand_worthc_one%
%cmi_worth_buy_[itemIdName(:data)]%
%cmi_worth_sell_[itemIdName(:data)]%
%cmi_worthc_buy_[itemIdName(:data)]%
%cmi_worthc_sell_[itemIdName(:data)]%

Note: You can use /sell, /worth, etc as well by configuring the Alias.yml file.

You can check the commands page and the permissions page to learn which commands and permissions along with them can be part of what you want out of the worth system you are trying to create.

Players

Players can hold an item in their hand and walk up to a hologram created by you, which, if configured correctly, can show the item they're holding, the amount of that item, and how much it's worth based on the data from the worth.yml file of CMI.

Alternatively, they can hold the item and type /cmi worth, assuming you gave them permission to use it. Doing this command will print the item's value in the chat.

Optionally, if you've given players permission to use /cmi sell, they can also type /cmi sell gui to open up a GUI, where they can drop items inside of the GUI. The title of the GUI will show how much money they will receive prior to selling their items. The other option is to directly use a command that will say in chat how much they've earned.

Server Owner

The server owner must give players the permissions to use /cmi worth, /cmi sell, etc.

You must go through the worth.yml file and edit the worth values to your liking. Optionally, you can use /cmi setworth to set the prices for items in-game.

Pro tip: If you have set the price for a base material, you can run cmi generateworth from the console. This will iterate through all the recipes of an item and calculate their sell prices.

Pro tip #2: Typing /cmi worthlist -missing in-game will open up a GUI showing all the items that do not yet have a worth value.

Find Commands:

> cmi checkcommand worth
[INFO]: --------------------------------------------------
[INFO]: 1. generateworth
[INFO]: 2. setenchantworth
[INFO]: 3. worth (all/blocks/hand/material)
[INFO]: 4. setworth (itemname) -s:(sellPrice)
[INFO]: 5. worthlist (playerName)
> cmi checkcommand sell
[INFO]: --------------------------------------------------
[INFO]: 1. sell (all/blocks/hand/same/gui)

Find Permissions:

> cmi checkperm worth
[INFO]: --------------------------------------------------
[INFO]: 1. cmi.command.generateworth - Auto generate posible item worth values
[INFO]: 2. cmi.command.worthlist - Check list of items with set sell prices
[INFO]: 3. cmi.command.worth - Check item worth
[INFO]: 4. cmi.command.setenchantworth - Change enchantment worth
[INFO]: 5. cmi.command.worthlist.others - Check list of items with set sell prices
---->When command is used on another player<----
Base command required
[INFO]: 6. cmi.command.setworth - Change item worth
> cmi checkperm sell
[INFO]: --------------------------------------------------
[INFO]: 1. cmi.command.sell.[blocks/all] - Allows to sell items not only from your hand
[INFO]: 2. cmi.command.worthlist - Check list of items with set sell prices
[INFO]: 3. cmi.command.sell - Sell items from inventory

Sell Sign

https://www.youtube.com/watch?v=lK_Pr3h7Bag&list=PLAgWLDdkOWlq8pnYuzIVAl2doNg1vmDD_&index=6

Using CMI's Interactive Commands, Specialized Commands, combined with the sell feature, you can create a sign that players can click to sell whatever they're holding.

More info of an item shop here:

https://www.zrips.net/itemshop/

Sell Hologram

You can also visually display what something is worth using a combination of features.

Here's an example I use on my servers. Note that the name of the world and the hologram location is specific to my server, and won't work on yours. You'd have to change this if you wish to copy and paste it to use on your own servers.

Worth:
  Loc: world_survival;12551.44;80.06;-5341.47
  Interval: 0.3
  Range: 3
  RangeExtra: 3
  Spacing: 0.22
  SpacingIcon: 0.5
  Interactable: true
  Commands:
  - asPlayer! cmi sell hand
  Lines:
  - '&6 %cmi_iteminhand_displayname% &fx %cmi_iteminhand_amount%'
  - '&bWorth: &e %cmi_iteminhand_worth%'
  - ICON:%iteminhand%