[mod] EmpyrionShipBuying

Discussion in 'Empyrion API' started by ASTIC, May 19, 2019.

  1. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,094
    Likes Received:
    735
    EmpyrionShipBuying
    Installation
    1. Download der aktuellen ZIP datei von https://github.com/GitHub-TC/EmpyrionShipBuying/releases
    2. Upload der Datei im EWA (EmpyrionWebAccess) MOD oder händische installation mit dem ModLoader aus https://github.com/GitHub-TC/EmpyrionShipBuying
    Wo für ist das?
    Hiermit können Schiffe aus einem Katalog oder von Spielern (über den Fraktionschat) gehandelt werden.

    Dabei bestimmt die Position des Verkäufers beim Verkauf automatisch die spätere Position in dessen Nähe sich der Käufer befinden muss. Auch die Postion des Schiffes beim Verkauf ist die gleiche, an der das Schiff beim Kauf in das Spiel eingefügt wird.

    HelpWithCatalog.png

    Schiffe im Katalog zur Verfügung stellen:
    • Als erstes stelle dich an die Stelle von wo aus der spätere Kauf getätigt werden soll. Dann gibst du folgenden Befehl ein: \ship add <ID> <Preis> und Entertaste wobei die erste Zahl der ID des zu verkaufenden Schiffes ist.
    • Das Schiff wird nun aus dem Spiel gelöscht und in dem Verzeichnis der Mod hinterlegt
    Schiffe verkaufen:
    • Als erstes stelle dich an die Stelle von wo aus der spätere Kauf getätigt werden soll. Dann gibst du folgenden Befehl ein: \ship sell <ID> <Preis> und Entertaste wobei die erste Zahl der ID des zu verkaufenden Schiffes ist.
    • Das Schiff wird nun aus dem Spiel gelöscht und in dem Verzeichnis der Mod hinterlegt
    • Du kannst das Verkaufsangebot des Schiff wieder zurücknehmen und bekommst gegen eine kleine Gebühr (i.d.R. 10% des Verkaufspreises) dein Schiff wieder
    Schiffe kaufen:
    • Wenn dies nicht durch LCDs etc. kenntlich gemacht wurde ermittle die Kaufposition mit Hilfe des Kommandos "\ship help" im Fraktionschat
    • Begib dich dich an die Stelle von wo aus der Kauf getätigt werden kann.
    • Nun kannst du per "\ship buy <number>" das Shiff aus der Liste kaufen die an dieser Position angeboten werden
    • Wenn der Kauf erfolgreich war wird das Schiff an der Verkaufsposition für dich privat zur Verfügung gestellt
    Kommandos
    Die Kommandos funktionieren NUR im Fraktionschat!

    • \ship help => Liste der Kommandos und der zum Kauf angebotenen Schiffe in diesem Playfield
    • \ship catalog => Liste der Kommandos und der zum Kauf angebotenen Schiffe über alle Playfields
    • \ship buy <number> => Startet den Kauf des Schiffes der Position <number> aus der Liste
    • \ship sell <id> <price> => Verkauft das Schiff mit der Id <id> und seinem ganzen Inhalt zu dem Preis <price>
    • \ship cancel <number> => Zieht den Verkauf des Schiffes an der Position <number> zurück. Hierbei fallen "Transaktionsgebühren" in Höhe von 10% an
    • \ship add <id> <price> => Stellt das das Schiff mit der Id <id> und seinem ganzen Inhalt zu dem Preis <price> in den Verkaufskatalog so das dies mehrfach gekauft werden kann
    • \ship profit => Transferiert den Gewinn der aus den Schiffsverkäufen erzielt wurde.
    Schiffe via EPB Datei anbieten
    Zunächst einfach einen 'normalen' Verkauf mit einer gespawten Version des Schiffes durchführen. Danach kann im [SaveGamePath]\Mods\EmpyrionShipBuying\ShipsData die EPB Datei abgelegt werden und der Dateiname in der Konfiguration im Abschnitt StructureDirectoryOrEBPName des Schiffes eingetragen werden. Hier können natürlich auch der Name und die Detailinformationen jederzeit geändert werden

    Konfiguration
    • LogLevel: Steuerung des Loggings
    • ChatCommandPrefix: Zeichenfolge mit dem die Chatkommandos beginnen müssen
    • SellPermission: Berechtigungen zum Verkauf von Schiffen
    • AddPermission: Beretigung zum hinzufügen von Schiffen zu dem Katalog
    • MaxBuyingPosDistance: Maximaler Abstand zu der Kaufposition
    • CancelPercentageSaleFee: Bestimmt wie viel Prozent Transaktionsgebühren fällig sind wenn ein Verkauf zurückgezogen wird
    • ForbiddenPlayfields: Liste von Playfield in denen kein Schiff zum Verkauf angeboten werden darf (i.d.R. wird man hier PvP Playfields eintragen)
    • Ships
      • DisplayName: Name des Schiffes
      • EntityType: Schiffstyp (HV, SV, CV)
      • StructureDirectoryOrEPBName: Verzeichnisname oder Dateiname der EPB Datei im 'ShipsData' Verzeichnis der Mod
      • ShipDetails: Detailinformationen über das Schiff
      • Price: Preis
      • Seller: Name des Verkäufers
      • SellerId: Wenn es sich um einen einfachen Verkauf handelt ist dies die EntityId des Spielers sonst ist sie 0
      • OnetimeTransaction: Handelt es sich um einen einmaligen Verkauf
      • SpawnLocation: Position & Rotation an der das Schiff erzeugt wird
      • BuyLocation: Position an der ein Spieler beim Kauf stehen muss
    • SaleProfits: Liste der EntiyIds der Spieler und ihr noch nicht abgeholter Verkaufserlös
    English-Version:

    Empyrion ShipBuying
    installation
    1. Download the latest ZIP file from https://github.com/GitHub-TC/EmpyrionShipBuying/releases
    2. Upload the file in the EWA (EmpyrionWebAccess) MOD or manual installation with the ModLoader from https://github.com/GitHub-TC/EmpyrionShipBuying
    What is it for?
    This can be used to trade ships from a catalog or from players (via the faction).

    The position of the seller in the sale automatically determines the future position near which the buyer must be. Also, the ship's position in the sale is the same as when the ship is inserted into the game when purchased.


    HelpWithCatalog.png

    Provide ships in the catalog:
    • First, imagine where the future purchase should be made from. Then enter the following command: \ship add <ID> <price> and Enter key where the first number is the ID of the ship to be sold.
    • The ship is now deleted from the game and deposited in the directory of the mod
    Ships sell:
    • First, imagine where the future purchase should be made from. Then enter the following command: \ship sell <ID> <price> and Enter key where the first number is the ID of the ship to be sold.
    • The ship is now deleted from the game and deposited in the directory of the mod
    • You can take back the offer of sale of the ship and get back your ship for a small fee (10% of the selling price)
    Buy ships:
    • If this was not indicated by LCDs, etc. determine the purchase position with the help of the command "\ship help" in the parliamentary group
    • Go to the place where the purchase can be made.
    • Now you can buy via "\ship <number>" Buy the ship from the list offered at this location
    • If the purchase was successful, the ship will be privately made available to you at the point of sale
    Commands
    The commands work ONLY in the fractional vote!

    • \ship help => List of commands and boats available for purchase in this playfield
    • \ship catalog => List of commands and boats available for purchase across all playfields
    • \ship buy <number> => Starts the purchase of the ship of position <number> from the list
    • \ship sell <id> <price> => Sold the ship with Id <id> and all its content at the price <price>
    • \ship cancel <number> => Attracts the sale of the ship at the position <number> back. In this case, "transaction fees" amounting to 10%
    • \ship add <id> <price> => Does that put the ship with Id <id> and all its content at the price <price> in the sales catalog so that this can be bought several times
    • \ship profit => Transfers the profit made from ship sales.
    Offer ships via EPB file
    First, just do a 'normal' sale with a pawed version of the ship. Then the EPB file can be stored in [SaveGamePath]\Mods\EmpyrionShipBuying\ShipsData and the file name can be entered in the configuration in the section StructureDirectoryOrEBPName of the ship. Here, of course, the name and the detailed information can be changed at any time

    Configuration
    • LogLevel: Logging control
    • ChatCommandPrefix: string with which the chat commands have to start
    • SellPermission: permissions to sell ships
    • AddPermission: Necessity to add ships to the catalog
    • MaxBuyingPosDistance: Maximum distance to the buy position
    • CancelPercentageSaleFee: Determines what percentage transaction fees are due when a sale is withdrawn
    • ForbiddenPlayfields: List of Playfields in which no ship may be offered for sale (here you will enter PvP Playfields here)
    • Ships * DisplayName: name of the ship * EntityType: Ship type (HV, SV, CV) * StructureDirectoryOrEPBName: directory name or file name of the EPB file in the 'ShipsData' directory of the mod * ShipDetails: detailed information about the ship * Price: Price * Seller: Name of the seller * SellerId: If it is a simple sale this is the EntityId of the player otherwise it is 0 * OnetimeTransaction: Is it a one time sale * SpawnLocation: Position & amp; Rotation at which the ship is generated * BuyLocation: position where a player has to stand when buying
    • SaleProfits: List of player's assets and their unclaimed sales proceeds
     
    #1
    Don't Panic likes this.
  2. SylenThunder

    SylenThunder Captain

    Joined:
    Jul 30, 2016
    Messages:
    219
    Likes Received:
    138
    I'm curious if this works with the current version. Tried to set it up, but maybe I'm just doing it wrong?
     
    #2
  3. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,094
    Likes Received:
    735
    #3
    Ephoie likes this.
  4. Deathstroke_BR®

    Deathstroke_BR® Ensign

    Joined:
    Jan 23, 2016
    Messages:
    7
    Likes Received:
    0
    hey thats a nice mod ! i've used this mod on 2019 had a lot of good ideas putting some of the risk X reward , now im trying to use it on my test server but it keeps crashing the playfield server whenever i use the commands.... do you got any solution for that?
     
    #4
    Last edited: Dec 26, 2021
  5. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,094
    Likes Received:
    735
    It worked only within the ModLoader because the ModLoader environment fixes some brocken API calls.
    You'll get the full preinstalled mod package ModLoader.zip here https://empyriononline.com/threads/mod-my-mods-astic-compatible-with-the-v1-6.49107/
     
    #5
    Deathstroke_BR® likes this.
  6. Deathstroke_BR®

    Deathstroke_BR® Ensign

    Joined:
    Jan 23, 2016
    Messages:
    7
    Likes Received:
    0
    #6
    Last edited: Dec 27, 2021
  7. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,094
    Likes Received:
    735
    You can also use the EWA version, but then you also need the current EWA version and have to update the ModLoader on the MOD page (stop mods, then update ModLoader at the bottom left and restart EGS via the server page).
     
    #7
    Deathstroke_BR® likes this.
  8. Lanthanum

    Lanthanum Ensign

    Joined:
    Nov 2, 2017
    Messages:
    12
    Likes Received:
    1
    Im not sure how to get ebp's to be purchasable in the catalog, seems to just trade the same ship around. If you buy a bp version does it spawn in the location set in config? So far I don't understand the purpose of the catalog when players can just buy the same exact ship over and over again so no one really owns it.

    I have placed the epb file in ShipsData and put the file name in the config where required. If I delete the specific id of the ship it wipes the config next restart. If I delete the ship in game ppl can just buy a missing ship over and over again. It would be cool if it gave them the bp ready to spawn or spawn the ship somewhere.

    when a ship is listed for sale it becomes public.

    Also when a ship is bought it converts to public not private so anyone can steal it if the buyer doesn't immediately change its faction.

    "/ship profit" can be repeated continuously

    [​IMG]
    https://gyazo.com/4ac85911024f7c7e7dd33aded76f17c0
     
    #8
    Last edited: Jan 18, 2023

Share This Page