GVNet Documentation

Everything you need to know about setting up and using GVNet

Overview

GVNet is a comprehensive Discord bot designed for Greenville Roleplay communities. It provides vehicle registration management, session organization, economy features, and more to enhance roleplay experiences across Discord servers.

Core Features

Vehicle Registration System

  • Register personal vehicles with detailed information
  • Track vehicle ownership and license plates
  • Enforce server-specific vehicle limits
  • Support for banned and semi-banned vehicles
  • Custom license plate validation

RP Session Management

  • Start and end roleplay sessions with customized rules
  • Vote system for session proposals
  • Session announcements with customizable embeds
  • Early access features for privileged roles
  • Session history tracking and statistics

Economy System

  • Virtual currency for server economies
  • Daily rewards and cooldowns
  • Business ownership and passive income
  • User-to-user transactions
  • Configurable economy settings per server

Welcome System

  • Customizable welcome messages for new members
  • Auto-role assignment
  • Server-specific configuration

Server Administration

  • Comprehensive server settings
  • Vehicle banning and restriction tools
  • Role-based permissions system
  • Statistics tracking

Command Reference

General Commands

Command Description
/help Shows comprehensive help information
/setup Interactive setup guide for server owners
/ping Check the bot's status and connection

Vehicle Commands

Command Description
/register Register a vehicle with year, model, state, color, and plate
/unregister Remove a registered vehicle
/vehicle list View your registered vehicles or others' (with permission)
/vehicle check Check if a license plate is registered
/request-car Request a car to be added to the database

Session Commands

Command Description
/session start Start a new RP session with FRP limits and peace time settings
/session end End the current session
/session vote Start a vote for a session
/session reinvites Send reinvites for a session
/session settings Configure session system

License Commands

Command Description
/license view View your driver's license

Business Commands

Command Description
/business create Create a new business
/business list View your businesses
/business collect Collect income from your businesses

Economy Commands

Command Description
/economy balance Check your balance
/economy collect Collect your daily allowance
/economy pay Send money to another user

Vehicle Management Commands

Command Description
/bv ban Ban a vehicle from use
/bv unban Unban a vehicle
/bv check Check if a vehicle is banned
/bv edit Manage banned vehicles
/bv roles Manage semi-banned vehicle roles
/bv limits Set vehicle registration limits

Welcome System Commands

Command Description
/welcome configure Configure welcome messages and auto-roles

Setup Guide

Initial Setup

  1. Invite the bot to your server with appropriate permissions:
    • Manage Roles
    • Send Messages & Embed Links
    • Read Message History
    • Add Reactions
  2. Run the /setup command as server owner to begin configuration

Setting Up Vehicle Registration

  1. Configure vehicle limits with /bv limits
  2. Set up semi-banned vehicle roles with /bv roles
  3. Add any banned vehicles with /bv ban
  4. Users can begin registering vehicles with /register

Setting Up the Session System

  1. Use /session settings to configure:
    • Announcement channel for sessions
    • Host role for session management
    • Session role for announcements
    • Early access roles
    • Vote threshold and duration
    • Cooldown settings

Setting Up the Welcome System

  1. Use /welcome configure to set:
    • Welcome channel
    • Auto-role for new members
    • Custom welcome message
    • Embed colors and appearance

Setting Up the Economy

  1. Economy settings are managed by server administrators
  2. Users can start using economy features with default settings
  3. Custom settings available for daily amounts, business costs, and more

Permissions and Roles

Host Role

  • Can start and end sessions
  • Can manage session announcements
  • Can create session votes

Semi-Banned Vehicle Access

  • Specific roles can be granted access to semi-banned vehicles
  • Server administrators can configure which roles have access

Administrative Permissions

  • Server settings require administrator permissions
  • Vehicle banning requires appropriate permissions
  • Economy settings require administrator permissions

Technical Information

Database Structure

  • MongoDB database for persistent storage
  • Collections for vehicles, server settings, economy, businesses, etc.
  • Backup systems for critical data

Integration with Roblox

  • Support for Roblox game links
  • Session announcement integration
  • Early access features

Customization Options

  • Custom embed colors and appearances
  • Server-specific limits and settings
  • Flexible configuration for all systems

Best Practices

Vehicle Registration

  • Keep vehicle information accurate and realistic
  • Follow server guidelines for vehicle types
  • Use proper format for license plates

Session Management

  • Clearly communicate FRP speed limits
  • Enforce peace time rules appropriately
  • Use reinvites when needed to maintain session population
  • End sessions properly when finished

Economy Usage

  • Daily rewards provide a steady income source
  • Businesses offer passive income opportunities
  • Balance expenses with income sources

Troubleshooting

Common Issues

  • Permission errors: Ensure the bot has appropriate server permissions
  • Configuration issues: Use the /setup command to verify settings
  • Vehicle registration errors: Check server vehicle limits

Support

  • For additional assistance, contact the server administrators
  • Report bugs or issues via the /feedback command