Functions
The functions section outlines unique functions and features added by the SWEconM mod.
Giftbags
Description: Creating a giftbag is a function that permits players to 'bundle' things into the inventory of a item. Meaning you can have a simple item that when opened gifts all the other things stored within it.
Obtaining
Giftbags cannot be crafted, but are acquired via commands only.
The /swecom giftbag [name] command can only be used on whitelisted items via the common config.
Creating a Giftbag
Hold a whitelisted (config) item in hand and use the command /sweconm giftbag namehere
"Successfully turned [name] into a giftbag."
Once converted into a giftbag, right-click the giftbag in hand to open the giftbag GUI. There are 27 slots (3 rows) which can be used to store gifts to give to another player.
The giftbag GUI can be closed at any time by pressing escape and items will remain stored within. Pressing Seal in the top right corner will seal the items within. While in this state, the item/block cannot be used in any way other than opening it and any attempts to do so will yield the items within.
Shown: A giftbag GUI for a SWEM ribbon stuffed with goodies. Note - the layout will not be seen by the recipient!
"This item cannot be used as a giftbag"
The item you are trying to use is not whitelisted as a giftbag item in configs.
"This item can no longer be used as a giftbag."
The item you are trying to use has already been used as a giftbag 2 times and cannot be used again.
"Cannot convert multiple items at once. Please hold only 1 item in a stack."
You must be holding a single item only in-hand to create a giftbag.
"This item is already a giftbag"
The item you are trying to use already contains items (is a giftbag) - open it, or leave it as a bundled giftbag.
Usage
Right-clicking a sealed giftbag will eject all items into the player's inventory. If their inventory is full, the items will be dropped. Once opened, the item can be used without issue, such as placing ribbons or rosettes on a wall, or in an item frame. The item will keep the giftbag name.
Known Issues
- [-] There is no way to reliably see if an item is a gift-bag without right-clicking it (yielding any items within and reducing it's number of re-uses). While creating a giftbag does give the item a name, this can easily be done via anvil, making it an unreliable means of determining whether an item is a giftbag or not. You can re-run the giftbag command, if it is already one you will be notified, but this will be limited to players who have access to this command.
Changelog
PVP
Description: If enabled via configs, players can have money stolen from their wallet during PVP.
Stealing Money
This information is based on the default values of SWEConM, these values can be configured in common configs!
Money can be stolen from a player when killed in combat on servers that permit PVP. This money will be given to the victor of the combat. If PVP is disabled, this function will not have any effect.
Amount
The amount stolen depends on the config specified value - by default this is 15%. This means upon a player's death in PVP combat, up to 15% of their total funds can be stolen.
Wealth
The amount stolen, or whether any funds can be stolen at all, also depends on the config specified value for wealth. By default a player must have a minimum of 100 Thyms in their wallet or wristlet to be stolen from. If they have less than 100, there is 0% chance they will lose any money following a PVP related death.
Protecting Funds
A player's money is only at risk if:
- The server permits PVP and the config has a greater than 0% chance of funds being stolen
- They have higher than the minimum wealth for PVP stealing in their wallet / wristlet
- They are carrying a deposit bag with money (and keepInventory is disabled) which can be dropped upon death
Wallet funds are associated with you as a player - the wallet or wristlet lets you access it but you can be stolen from with or without one. Keep the wallet value below the stealing wealth, or withdraw your funds to keep safely in a vault.
Players can protect their money by:
- Storing it securely in a SWEConM vault (coins / coins in a deposit bag)
- Storing it securely in an Ender Chest
- Storing is securely on a property with landclaim that does not permit other player's access to their valuables