Moved most of the wiki to sphinx

doc_update
Joey Hines 2019-01-02 17:48:31 -06:00
parent 320c1b1c61
commit 9936ec1590
3 changed files with 111 additions and 4 deletions

View File

@ -2,5 +2,10 @@
Commands API Commands API
============ ============
Commands exposed as part of the Geoffrey Command API
.. note::
To use these commands on the API, you must supply a valid token using the ``api`` parameter
.. automodule:: GeoffreyApp.api.commands .. automodule:: GeoffreyApp.api.commands
:members: :members:

View File

@ -0,0 +1,103 @@
.. _getting_started:
Getting Started with Geoffrey
*****************************
Geoffrey: A Discord Bot for Minecraft Servers
=============================================
Geoffrey was created to be an information source for base and shop locations on Minecraft severs. The bot mainly tracks
base, shop, and tunnel locations. This allows for users to quickly find each other's builds and find shops selling
goods.
Geoffrey can be used on a Discord server or in a private message with the bot.
Adding a base
-------------
First you must register with the bot if you are a new user::
?register
This allows Geoffrey to link your MC name with your Discord account.
Then you can add your first base::
?add_base 500 550
Your first base does not need a name, it defaults to "[Username]'s Base"
If you want to specify a name::
?add_base 500 550 My New Base
To delete a base::
?delete "My Base"
Adding a shop
-------------
A shop can be added like a base::
?add_shop 500 550
or::
?add_shop 500 550 Cool Shop
The following command then adds dirt to the shop with the price of 5 dirt for 1 diamond::
?add_item Dirt 5 1
Then you could delete that entry by::
?delete_item dirt
To delete a shop::
?delete "My shop"
If you have more than one shop, you need to specify the shop name.
Searching in the database
-------------------------
The ``?find`` command is used to find bases and shops in Geoffrey. ``?find`` searches for both location names and owner names::
?find ZeroHD
Then to find out more info about a location, use ``?info``::
?info ZeroHD's Base
``?selling`` can be used to find items for sale. Tip is better search for a subset of the item name
ig for `enderchests` search `ender`::
?selling ender
You can also search around a position for locations with ``?find_around``::
?find_around 0 0
Editing Locations
-----------------
To rename a base/shop you can do the following (the quotations around the location names are important!)::
?edit_name "Cool New Name" "Current Name"
To move a location's position, use ``?edit_pos``::
?edit_pos 420 69 Cool Base
To change the tunnel of a base, use ``?edit_tunnel``::
?edit_tunnel North 545

View File

@ -1,7 +1,5 @@
.. Geoffrey documentation master file, created by .. Geoffrey documentation master file, created by
sphinx-quickstart on Tue Jan 1 10:26:32 2019.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Geoffrey: Minecraft Server Info Database Geoffrey: Minecraft Server Info Database
======================================== ========================================
@ -13,4 +11,5 @@ goods.
:maxdepth: 1 :maxdepth: 1
:caption: Contents: :caption: Contents:
commands getting_started
commands