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.

image-1686085061030.png

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


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:

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: