DumpGil — FFXIV Marketboard Discord Bot

DumpGil is a lightweight Discord bot that fetches real-time Final Fantasy XIV marketboard listings using the Universalis API. It provides clean, readable Discord embeds and simple commands for quick price checks.

Setting up the environment for local use

• Open a terminal and navigate to your project folder.
• Create a virtual environment by running: python -m venv venv
• Activate the virtual environment:
  • On Windows (PowerShell): .\venv\Scripts\activate
  • On Mac/Linux: source venv/bin/activate
• Install the required packages by running: pip install -r requirements.txt
  • Optionally, confirm that the packages were installed correctly by running: pip list

After completing these steps, your virtual environment will be active and all dependencies from requirements.txt will be installed. You can now run your Python scripts or Discord bot within this environment.

Installation to Discord Server

Paste this url into the browser and Discord will prompt you to set up the bot.

https://discord.com/oauth2/authorize?client_id=1427062576461647995

Features

• Text-based commands
• Marketboard price lookup
• HQ-only filtering (expandable)
• Clean Discord embed output
• Built with discord.py
• Fetches live prices from Universalis API

Commands

$mb <item> Searches the marketboard for the specified item.

Example: $mb mate cookie

Returns:

$mb help Displays usage instructions and command format.

Configuration

This bot uses:

• discord.py
• requests
• Universalis API (https://universalis.app/api/v2)

Additional customization options include:

• Data center selection

• HQ/NQ filters

• Price history charts

Contributing:

Contributions are welcome. Open an issue or submit a pull request to help improve the project.