Skip to content

itsthedevman/MarXet

Repository files navigation

logo

Welcome to MarXet!

Exile's Leading Inmate Based Marketplace

DEVELOPMENT AND SUPPORT HAS CEASED.

MarXet is a server/client script made for Exile to provide a unique and dynamic player based market. Players can create new "listings" for any item or persistent vehicle in game with it's own price. Other players can then purchase any item/vehicle from MarXet.

Features

  • Dynamic, player based marketplace
  • Built using Exile's Security
  • Sell any item or any persistent vehicles
  • Accessible via placed MarXet Traders
  • GUI built to match Exile's GUI theme
  • Persistent, saves to the database

License Overview:

This work is protected by Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). By using, downloading, or copying any of the work contained, you agree to the license included.

Creative Commons License
MarXet by WolfkillArcadia is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

The following overview is a human-readable summary of (and not a substitute for) the full license.

You are free to:

Share — copy and redistribute the material in any medium or format.

Adapt — remix, transform, and build upon the material.

Under the following terms:

Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.

NonCommercial — You may not use the material for commercial purposes.

ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.

Notices:

You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation. No warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.

Installation

Installation is simple and easy with only one Exile overwrite.

extDB

  1. Copy MarXet-SQL.sql into your favorite mySQL viewer's query window and run it.
  2. Confirm you have a marxet table.
  3. Copy the contents of MarXet-extDB.ini into your @ExileServer\extDB\sql_custom_v2\exile.ini file at the bottom.
Server
  1. PBO MarXet_Server in SERVER_FILES and copy that to your @ExileServer\addons folder.
Client
  1. Copy MarXet from CLIENT_FILES into the root of your exile.MAPNAME folder.

  2. In either init.sqf or initPlayerLocal.sqf, add [] execVM "MarXet\MarXet_Init.sqf";

  3. CfgNetworkMessages.hpp both will depend on your set up.

    1. If you ALREADY have class CfgNetworkMessages ANYWHERE in your description.ext or config.cpp in your exile.MAPNAME folder:

      1. Add #include "MarXet\CfgMarXetNetworkMessages.hpp to class CfgNetworkMessages
      2. It should look something like what is below.
    2. If you don't have class CfgNetworkMessages, in your config.cpp, add this at the top.

       class CfgNetworkMessages
       {
           #include "MarXet\CfgMarXetNetworkMessages.hpp"
       };
      
  4. At the top of config.cpp add #include "MarXet\CfgMarXet.cpp"

  5. At the top of description.ext add the following:

     #include "MarXet\dialog\RscMarXetDefines.hpp"
     #include "MarXet\dialog\RscMarXetDialog.hpp"
    
  6. You are done! Head on down to configuration.

Configuration

Traders and Objects

Located in MarXet folder in your exile.MAPNAME mission folder, there is a file called MarXet_Traders.sqf. The trader setup code is like Exiles', except instead of a setVariable, they have a pushBack.

General Config

The file called CfgMarXet.cpp, located in MarXet\ in your exile.MAPNAME mission folder, has a few important system settings in it. Please make sure to read them. As MarXet updates and evolves, this file will be the source of 90% of the config options, make sure to continue to check it.

Changelog

Version 2.2 [June 29 2016]

Happy Exile update! This is the compatibility patch for Exile version 0.9.8. This patch WILL NOT work with any Exile versions before 0.9.8

  • Switched to new Exile money.
    • Note: Selling and buying both use the "physical" money. Unfortunately, as that lockers are server configurable, the player may lose money if a payment from a sold item went to their locker. I will look into a better way of handling this for version 3.0. If you have an idea, feel free to comment on the forums
  • Switched from CfgHints to Exile's new "toast" notification system.
  • Added checks to make sure CfgMarXet and CfgNetworkMessages exist in the missionConfigFile.
    • If not, server RPT will be spammed, MarXet won't run and client won't place traders ;)
  • Added ability to disable item restriction and item deletion in database.
    • Change the settings in CfgMarXet to -1 to disable.
  • "buyNowRequest" no longer keeps the item locked if it reaches an error.
  • Changed MarXet trader parameters to new Exile format
  • Updated CfgNetworkMessages

Version 2.0 [June 19 2016]

  • Added ability to sort listings (GUI dropdown)
  • Listings now have a restriction date (Configurable, check CfgMarXet.cpp)
    • If a listing hasn't been bought in a certain timeline, the database will set the sellersUID to 0, which keeps the seller from making any money on the item
  • Listings that have been restricted will be removed after a certain time (Configurable, check CfgMarXet.cpp)
  • Listing a vehicle will prompt you with a confirmation before listing
  • Purchasing a listed vehicle now requires you to set the pin first
  • Listed vehicles now have a "rekey charge" added onto the list price.
    • Price is pulled from config.cpp and is the same price as Exile's default rekey price
    • (If buyer is seller) Buying back listed vehicles will cost just the rekey charge.
    • (if buyer is seller) Buying back listed vehicles will warn the player that they originally listed that vehicle and it will cost them a rekey charge.
  • Listed items that the player originally listed will show up as 0 or the rekey charge if a vehicle.
  • Added ability for vehicles to spawn on pre-placed helipads (Check CfgMarXet.cpp)
  • Fixed standard sorting filter (It was backwards!)
  • Clean up code a little
  • Probably created more bugs

Updating to version 2.2 from 2.0

Client and server have been updated.

Client
  • Remove class CfgHints {}; if MarXet was the only thing in it. Or remove #include "MarXet\CfgMarXetHints.hpp"
  • (If you overwrote this via config.cpp) Remove the ExileServer_system_network_dispatchIncomingMessage overwrite from config.cpp as that it's included in Exile 0.9.8 by default.
  • Delete MarXet folder from Mission folder and copy the one from the github
  • NOTE: If you made custom traders for your map, make sure you adjust them for the new format that Exile uses or your traders will not spawn.
Server
  • Delete MarXet_Server.pbo
  • PBO MarXet_Server.pbo from the github and place it in @ExileServer\addons folder.

About

Dynamic Player Based Trading System for Exile

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published