diff --git a/docs/guides/new_players/trading.mdx b/docs/guides/new_players/trading.mdx index f7c2d182..d8be84ec 100644 --- a/docs/guides/new_players/trading.mdx +++ b/docs/guides/new_players/trading.mdx @@ -5,18 +5,26 @@ description: "The guaranteed exchange." {/* Bits symbol: ⌽ */} {/* Bits color: F */} +{/* Qubits symbol: ⓠ */} +{/* Qubits color: T */} + +> Mutuality is mandatory. + +_- ((%V\%%)), ((risk.reward))_ ## The trading system -In hackmud, trading is an alternative method to exchange resources between users, and the only method of exchanging ((%Fbits ⌽%)) between players. +In hackmud, trading is an alternative method to exchange resources between users, the only method of exchanging ((%Fbits ⌽%)), and the process through which ((%Tqubits ⓠ%)) are realised. + +Instead of using ((accts.xfer_gc_to)) and ((sys.xfer_upgrade_to)), trading uses the ((%Ctrade%)) shell command, and has its own interface and fees. -Instead of using ((accts.xfer_gc_to)) and ((sys.xfer_upgrade_to)), trading uses the ((%Ctrade%)) shell command, and has its own special interface and fees. +## Starting a trade -### Starting a trade +The syntax for starting a trade is ((%Ctrade% %V\%)). This will send a trade request to the inputted user, and they must do the same, with your name. -The syntax for starting a trade is ((%Ctrade% %Auser%)). This will send a trade request to the inputted user, and they must do the same, with your name. +To trade as a corp representative, replace ((%Ctrade%)) with ((%Ctrade_corp%)). -#### Example +### Example `angie` wishes to trade with `bo`, so `angie` sends `bo` a trade request: @@ -40,6 +48,7 @@ At which point both parties then see the trade interface appear: ║ trade 68b1152c50334a086f9b258e ║ ╙━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╢ angie offers ║ bo offers +┗ AS SELF ║ ┗ AS SELF ━━━ ║ ━━━ ║ -- EMPTY -- ║ -- EMPTY -- @@ -51,13 +60,13 @@ for usage see trade_help A trade has begun. -### Making offers +## Making offers -((GC)), upgrades, and ((%Fbits ⌽%)) can be offered using the commands outlined in ((%Ctrade_help%)). +((%CGC%)), upgrades, ((%Fbits ⌽%)), and ((%Tqubits ⓠ%)) can be offered using the commands outlined in ((%Ctrade_help%)). There will be a trade fee based on what is offered, which is outlined later in detail. -#### Commands +### Commands The commands for making offers, as shown in ((%Ctrade_help%)): @@ -72,32 +81,86 @@ trade_rem [removes an offered upgrade from your offers trade_up_info [shows detailed upgrade information for an offered upgrade] ``` -### Concluding a trade +### Offering qubits (and corp donations) + +To offer ((%Tqubits ⓠ%)) for realization, you use the same command as when offering ((%Fbits ⌽%)) (((%Ctrade_bits%))), and ((%Tqubits ⓠ%)) will be offered first, given the current trade is a corp donation. + +To be a "corp donation", the following criteria must be met: + +- Exactly one party is acting as a corp +- The non-corp party is offering ((%Fbits ⌽%)) (((%Fbits ⌽%)) and ((%Tqubits ⓠ%)) are treated the same) +- No other items are offered by either party + +Corp donations have no trade fee. + +When ((%Tqubits ⓠ%)) are offered in a donation and the trade is completed, the offered ((%Tqubits ⓠ%)) will be realized as ((%Fbits ⌽%)) in the corp's "bits purse". + +## Concluding a trade Trades can end in two ways: both parties accept the trade and the resources are exchanged, or one party runs ((%Ctrade_end%)) and no resources are exchanged. -### Fees +## Fees Use of the trade system incurs a fee, paid with ((%Fbits ⌽%)). The minimum trade fee is ((%F3⌽%)) -The fee is based on the resources exchanged on completion of the trade - not all resources present - with the following calculations: +The fee is based on the resources exchanged on completion of the trade - not all resources present, + +The trade fee will be reduced if the involved parties are corp representatives or COMCODE supporters. + +These fee reductions apply as "stacks" - multiple instances of criteria being met will reduce the fee further. +For example: both parties being supporters will apply two "stacks" of fee reduction. + +Corp representative and COMCODE supporter criteria are not mutually exclusive, allowing for up to 4 stacks of fee reduction when both parties are supporters and trading as corps. + +Corp donations (outlined above) have no fee. + +If fee reduction criteria are met, it will be displayed in the trade UI. + +### Bits + +The fee on an exchange of bits is calculated as a percentage of the bits exchanged, with the following values: + +| Reduction Stacks | Fee % | +| :--------------: | :----: | +| 0 | 5% | +| 1 | 4% | +| 2 | 3% | +| 3 | 2% | +| 4 | 1% | +| Corp donation | No fee | + +### GC + +The fee on an exchange of ((GC)) is calculated as a percentage of the ((BGC)) exchanged, with the following values: + +| Reduction Stacks | Fee % | +| :--------------: | :---: | +| 0 | 50% | +| 1 | 40% | +| 2 | 30% | +| 3 | 20% | +| 4 | 10% | + +### Upgrades -- 4% of ((%Fbits ⌽%)) exchanged; -- 30% of ((%JB%%CGC%)) exchanged; -- Upgrade rarity, based on the below table; +The fee on an exchange of upgrades is based on the rarity of the upgrades, with the following values: -| Rarity | Fee Amount | -| :----------------: | :---------: | -| ((%0noob%)) | ((%F3⌽%)) | -| ((%1kiddie%)) | ((%F3⌽%)) | -| ((%2h4x0r%)) | ((%F3⌽%)) | -| ((%3h4rdc0r3%)) | ((%F15⌽%)) | -| ((%4\|\_\|b3\|2%)) | ((%F30⌽%)) | -| ((%531337%)) | ((%F150⌽%)) | +| Rarity | 0 Reduction | 1 Reduction | 2 Reduction | 3 Reduction | 4 Reduction | +| :----------------: | :----------: | :----------: | :----------: | :----------: | :----------: | +| ((%0noob%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | +| ((%1kiddie%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | +| ((%2h4x0r%)) | ((%F5 ⌽%)) | ((%F4 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | ((%F3 ⌽%)) | +| ((%3h4rdc0r3%)) | ((%F25 ⌽%)) | ((%F20 ⌽%)) | ((%F15 ⌽%)) | ((%F10 ⌽%)) | ((%F5 ⌽%)) | +| ((%4\|\_\|b3\|2%)) | ((%F50 ⌽%)) | ((%F40 ⌽%)) | ((%F30 ⌽%)) | ((%F20 ⌽%)) | ((%F10 ⌽%)) | +| ((%531337%)) | ((%D[404]%)) | ((%D[404]%)) | ((%D[404]%)) | ((%D[404]%)) | ((%D[404]%)) | -### Notes +## Notes - You cannot offer something the other party is unable to hold. - You can trade among your own users, but you cannot offer ((%Fbits ⌽%)). + - With the exclusion of corp \<-> user and corp \<-> corp trades. - The trade system can exceed the ((32BGC)) xfer limit. - Each party appears to only be able to offer 1 upgrade. +- Fees of rarity 5 upgrades are currently undocumented due to lack of publicly available data. +- Fee reduction stacks are counted based on the users. + - A supporter doing a trade between their own users (no corp parties) would have 2 stacks of fee reduction, not 1.