Simple User Guide ( Draft )

May 29, 2009 at 3:25 AM
Edited May 29, 2009 at 8:54 AM

1. Mall Manager

Type [Manager in game to generate the mall manager. This is the first to do in setting up a vendor mall.


Single click on the manager, the mall setup context menu will appear.

Context Menu,


- Setup

The manager's 'Setup' menu allows you to setup your vendor mall.


Sub menu in ‘Setup’,

1)    Setup Area

2)    Add Tiles

3)    Spawn Wanderer

4)    Spawn Restocker

5)    Spawn Petseller

6)    All go home

7)    Setup Tile

8)    Convert Tiles


Setup Area

This is to setup areas for your vendor mall. Your mall areas can be in cities, the wildness or even deep down the dungeons.


Add Tiles

This is to add the vendor tiles within the marked mall areas. Players can thus purchase a “Vendor Deed” and to place their vendors onto the mall tiles. Without placing the mall tiles first, players cannot setup their own vendors in the mall.


Spawn Wanderer

This is to spawn the Wandering Trader to the mall. Staff can add items and pets to the Wandering Traders such that shard players can buy, or to bargain, or place bids on those items. They are NPC vendors walking / wandering within the mall.


Please refer to the ‘Wandering Trader’ section for details about the Wandering Traders.


Spawn Restocker

This is to spawn another type of NPC vendors, the Restockable Vendors. Staff can add items and pets to these Restockable Vendors such that shard players can purchase those items. They are different from the Wandering Traders in that their inventories are automatically re-filled, more or less like a usual NPC vendor in game. Player can purchase items from them, but bids cannot be placed on the selling items, because it is meaningless to bid for items which will be refilled regularly.


Technically speaking, Restockable Vendors can only sell items with a default constructor.


Please refer to the ‘Restockable Vendor’ section for details of these Restockable Vendors.


Spawn Petseller

This is to spawn yet another type of NPC vendors, the Pet Sellers. The Pet Sellers are more or less like the Wandering Traders. However, they sell only pets, but no other items. Pet Sellers will open road shows when players are near by to show off their pets on sale. Players can ‘hire’ these Pet Sellers to sell their own pets. At the same time, staff can also add pets for the players to purchase, to bargain and to place bids.


All go home

Normally, all the spawned vendors will only walk inside the vendor mall. However, when the areas and thus the size of the mall are changed, and you want those walking vendors to walk inside the newly defined areas, you can use this ‘All go home’ function. This will send all the walking vendors to the centre of the mall, and reset their walking ranges, such that they will walk inside the new mall areas.


Setup Tile

Both the tile style and color can be changed. ‘Setup Tile’ opens a Gump for you to choose from a set of tiles to match your mall’s environment theme. Say, if your mall is setup in a snow white icy area, you might want the tiles to be the light colored ones. To do so, you can choose a tile style matches that environment, and you can also change the tile’s color hue.


Convert Tiles

After changing the tile style and hue in ‘Setup Tile’ above, the ‘Convert Tiles’ allows you to apply the changes to the whole mall. This function simply changes all the tiles inside the mall areas into the new tile and hue you selected in ‘Setup Tile’.


- Goto Loc

This is to change the manager’s standing location. After setting up the mall, you may want to change the manager’s standing position to a location more accessible to the players. You can use this ‘Goto Loc’ function to set the manager to your standing spot, facing the same direction as you are.


- Buy

The manager's 'Buy' menu allows you to buy,

1) Vendor Mall Deed

2) Bidding Account Book

3) Stay Home Deed


Vendor Mall Deed

Players need to purchase a ‘Commissioned Contract’ from the mall manager, in order to setup their player vendors to the mall. The player vendors to be setup will charge on a commission basis, instead of the traditional daily basis. As a result, players no longer need to worry about the dismissal of their vendors due to the lack of fund, as their vendors will never leave by themselves.


After purchasing the Commissioned Contract, which is usually referred to as a ‘Vendor Deed’ or ‘Contract of Employment’, the player can double click the deed and point to an existing mall tile to establish his Commissioned Vendor.


Please refer to the ‘Commissioned Vendor’ section for details about these player run vendors.


Bidding Account Book

Before a player can join an auction or bidding, he needs to purchase an account book from the mall manager. The account book will help the player to keep track of his bidding records. And the Bidding Account Book is not mall-dependent, which means, the same account book can be used to store bid records from the various malls in your shard.


Stay Home Deed

This is very similar to the ‘Commissioned Contract’ right above. Yet it’s different in that it cannot be used in the mall, rather it allows players to setup their Commissioned Vendors inside their own houses. When a Commissioned Vendor is placed at home instead of a mall, bidding is not allowed. Bidding or auction only occurs in a vendor mall.


- [Props

Certain properties of a mall Manager can only be set and changed through [props, including,



2. Commissioned Vendor

It is a player setup and run vendor. A Commissioned Vendors charges commissions based on sales transaction instead of a daily charge. A player can add both items and pets to his commissioned vendor for sale. He can also place items and pets for demonstration and bidding purchase.


It can be placed in a public vendor mall, or it can be placed at a player’s own house. Bidding is not allowed however if it is placed at home instead of in mall.


Commissioned Vendors, at the same time, are also usual player vendors. It means that you can place items to their backpacks for sale in a traditional way. However, commissions are charged instead of a daily charge.


Commissioned Vendor sub-menu,

1)    Setup

2)    Add

3)    Shop Inventory

4)    Offer



This allows you to specify whether the items/pets in your sales inventory are allowed to be bidden. It only works for commissioned vendors inside a vendor mall, as auction/bidding is not allowed for home-stay vendors. When ‘allow bidding’ is set to ‘true’, players can place bids to all your sales items/pets, and demo items/pets. Demo items are those items without a price set, that is, the ‘Not for Sale’ items.



This is to allow the owner of a Commissioned Vendor to add in items and pets to sell. The owner can sell any items owned. As for pets, only bonded pets are allowed to be sold. Stable slots will be used for the selling of pets. An extra 5 slots are added to his stable quota though. That is, if the owner’s maximum stable slots are 7, his owned Commission Vendors can sell up to 7 + 5 = 12 pets. But if his stable slots are already full, he can only add 5 pets for his Commissioned Vendor to sell.


Shop Inventory

This is to show the selling items and pets using a graphical Gump, similar to the Gump you are using to submit minor ‘Treasure of Tokuno’ artifacts in Tokuno Zento. When you click on the displayed items, a box will show up with the specified item placed inside, such that the buyer can have a look at what the true item is like, with its property information, to purchase the item or to place a bid on the item.


In case of pets, an extra menu option ‘Info’ is available for the buyers to know more about extra information of the selling pet, information that cannot be displayed and known of using the ‘Animal Lore’ skill.


Please refer to the ‘Items’ and ‘Pets’ sections for more details on selling Items and Pets.



This is to allow buyers to place bargains and bids. A bargain is a placing of bids with prices lower than the owner’s set prices. It is thus a bargain back to the seller. When the seller/owner accepts the negotiated price, he/she needs to actively approve the bargain, such that the item or pet to be sold goes to the successful bargainer.


On the other hand, the sellers/owners may set the prices of their selling items and pets to a negative value. A negative value denotes that the items/pets are not for sale, but for either demonstration or for bidding. If it’s for demonstration only, the owners may disable the bidding capability by using ‘Setup’ above to set the ‘Allow Bidding’ to false.


Please refer to the ‘Prices’ section for details on prices.



3. Wandering Trader

They are the walking vendors, and they are setup by staff. They will only walk inside the mall areas and will not wander away. Staff can add items/pets to them for players to purchase, to bargain and to bid. They can also be used by staff for demonstrating special shard items.


Their sales inventory will not be re-filled. That is, they sell only unique items and pets. Once the items and pets in inventory are sold out, the inventory will be empty.


It is similar to that of a player vendor, when all the items in a player vendor’s backpack are sold out, his backpack will be empty. It’s different from a player vendor in that, 1) it is owned by staff, and 2) it wanders around instead of standing still like a log.


Wandering Trader sub-menu

1)    Setup

2)    Add

3)    Shop Inventory

4)    Offer



‘Setup’ is used for two purposes. One is for currency while the other is for allowing/disallowing bids. Currencies other than Gold can be used as the currency of a vendor. And anything “stackable” can be used as a currency.


When ‘Allow Bidding’ is set to ‘true’, players can place bids on the selling items. Winning, however, is not automatic. A staff needs to ‘approve’ the winning bids actively. Or else, the bids will go expire without anyone winning them. As for details, please refer to the ‘Offer’ section.



This is to allow a staff to add unique and biddable items to the Wandering Trader. Unique and biddable means the inventory of the items and pets to be sold will not be refilled automatically, more or less like the selling items inside the backpack of the player vendor. They are usually very rare items or pets, or items and pets which a staff needs to gain control over their populations.


Shop Inventory

It is the same as the ‘Shop Inventory’ in the ‘Commissioned Vendor’ section. It opens a graphical Gump for the buyers to view the item/pet information, to purchase the item and to place bids. At the same time, it allows to staff to setup the prices, description and to remove items/pets from the selling inventory.



This option allows staff and players to browse through the currently under bidding items and pets. Players can join the bidding or cancel their bids, while staff can approve the winning bids.


A staff can type [Add StaffBidLedger to obtain a book recording all the currently bids placed by players on items and pets sold by the Wandering Traders and Pet Sellers. And through this book, the staff can directly recall to the vendors to approve the bids.


4. Pet Seller

They are special kind of Wandering Traders. They sell only pets but not items. They accept both pets from staff and players and sell the pets for them. Staff can thus ‘Add’ pets to them for sale, while players can also ‘Hire’ them to sell their pets.


Although other kinds of vendors can sell pets, only a Pet Seller can start a road show to show off your pet. When players are nearby, a Pet Seller will open a road show for the demonstrating of his selling pets.


Similarly to the Wandering Traders, Pet Sellers sell only unique pets which will allow players to place bid, yet the inventory will not be re-filled.


Pet Seller sub menu

1)    Setup

2)    Hire

3)    Add

4)    Shop Inventory

5)    Offer