Bots: Difference between revisions

Help

Revision as of 19:37, 6 October 2025

Botting, as it refers to automated gameplay, is against the rules and will result in a ban. The bots mentioned here are different.

The term "Bots" refers to Chat bots that assist in gameplay. These bots, not owned by the developer Smitty, are created by players.

References to a whitelist/blacklist for bots pertain only to individual bots and have nothing to do with one's ability to interact with the game in any way.

Dounbot

Dounbot is developed by Dounford its prefix is !, for the list of commands you can send !help in chat. It works on global chat, its private messages and on Bondfire Map.

The default cooldown is 30 seconds, reduced to 15 seconds for users with permission level 1 and no cooldown for users with permission level 2 and 3.

Additionally, ignored texted can be placed after any command by using the @ symbol. For example, "!wiki mining @check this" will just respond with https://flatmmo.wiki/index.php/Mining

COMMAND	PERMISSION LEVEL	USE	DESCRIPTION	ALIAS
help	0	!help	Shows a list of available commands	h
bondfire	0	!bondfire	Shows if the bondfire is active and its remaining time	bonfire
map	0	!map [item_to_search]	Send a link to Interactive Map, if the first parameter is used it will search for the item location
meteor	0	!meteor	Replies with the last known meteor location	m
setmeteor	0	!setmeteor <location>	Sets the current meteor location This can only be used on /yell (#global) Usage: !setmeteor 3 willows	sm, setlocation
xp	0	!xp [level] [xp] [xpPerAction]	If no parameter is used sends a link to xp calculator If the first parameter is used it replies with the required xp needed to get that level from 0 If the second parameter is used it replies with the required xp needed to get to that level minus the second parameter If the third parameter is used it replies with the amount of actions required to get to that level	level
wiki	0	!wiki [page_name]	Send a link to wiki, if the first parameter is used it will send to the page	w
maparea	0	!maparea <map_id>	Send a link to Interactive Map and search for the map id used
discord	0	!discord	Sends an invite to official discord server
scripts	0	!scripts	Sends a link to the Scripts list
mining	0	!mining	Sends a link to mining data sheet
woodcutting	0	!woodcutting	Sends a link to woodcutting data sheet	wc
hunting	0	!hunting	Sends a link to hunting data sheet
flip	0	!coin	Throws a coin and replies with the result (Heads or Tails) It has 0.00000000000000001% of chances of being a draw	coin, toss, coinflip
random	0	!random <max>	Replies with a random number between 0 and max, if max is negative it is between max and 0 instead Its range is -10,000 and 10,000
invalidate	3 or being a script maker	!invalidate <script>	Invalidates the cache of a script from flat chat /load It can only be used on pm

By default all players have a permission level of 0.

<parameter> are required and [parameter] are optional.

Giveaway

COMMAND	USE	DESCRIPTION	ALIAS
giveaway	!giveaway [winners]	Starts a giveaway It lasts 5 minutes or until !end is used [winners] defaults to 1 The giveaway id is informed as soon as it starts
enter	!enter	Enters the current giveaway if one is happening
left	!left	Replies with the current giveaway remaining time
entries	!entries	Replies with the amount of players that entered the current giveaway
end	!end	Ends the current giveaway Only the giveaway host can end it
reroll	!reroll <winners> <giveawayId>	Rerolls new winners from any of the past giveaways Anyone can reroll it any giveaway It can't be used while another giveaway is happening
donations	!donations [username]	Replies the current and total balance [username] defaults to the command sender	funds

Take in mind that Bondfire Map and /yell have separated giveaways.

Giveaway related commands don't have cooldown, but if you spam it you may and will be blocked.

New Year's Eve Lottery

COMMAND	USE	DESCRIPTION
donors	!donors [startingPlace]	Replies with the leaderboard of donations for the New Year's Eve Lottery
bigprize	!bigprize	Replies with the current pot of the New Year's Eve Lottery
ticket	!ticket <number 1> <number 2> <number 3> <number 4> <number 5> <number 6>	This command can only be used from December 1 to December 31 Buys a ticket for the big prize lottery 6 unique numbers from 1 to 60 have to be chosen This costs 10k coins donated to Dounbot located on the bondfire 1 Ticket per User

All Coins donated to Dounbot are added to the New Year's Eve Lottery pot.

Players with 6 matching numbers get 80% of the prize and with 5 numbers get the other 20%, in case of multiple winners the prize is evenly distributed.

The prize can be claimed as soon as the winner is announced by trading with Dounbot. Winners have until January 7 to claim the prize.

If the prize, or part of it, is not claimed until January 7th it will expire and can be used to any purpose.

Moderation

COMMAND	PERMISSION LEVEL	USE	DESCRIPTION
block	3	!block <username> [reason]	Blocks someone from using any bot command A reason can (and should) be given
unblock	3	!unblock <username>	Unblocks someone from using the bot commands
blocked	3	!blocked [username]	Replies with all blocked users If the first parameter is used it show if someone is blocked and if they are who blocked
reason	3	!reason <username>	Replies with the reason someone was blocked
perm	3	!perm <username> <level>	Changes a player permission level
showperm	3	!showperm [page or username]	If a number is used as argument it will show a page with 5 players and their permission levels in it If a username is used it will show the permission level of the player
addmaker	3	!addmaker <username>	Allows the player to use !invalidate
removemaker	3	!removemaker <username>	Disallows the player to use !invalidate
listmakers	3	!listmakers	Replies with all players that have access to !invalidate
refund	3	!refund <username> <amount>	Adds the <amount> to the <username> current balance It only changes the current, not the total
fiesta	3	!fiesta	Set the price to start a giveaway to 0 It lasts until the bot is restarted or !endfiesta is used
endfiesta	3	!endfiesta	Sets the price to start giveaways back to 10k
draw	3	!draw	DO NOT USE IT BEFORE DECEMBER 31 Starts the New Year's Eve Drawing A random unique number from 1 to 60 will be selected each 30 seconds After 6 numbers it will start to search for winners, if no one has the winning numbers it will continue to draw until someone has 6 matching numbers When it is done the winning sequence(s) along with the winner(s) will be yelled After each number is drawn they are save, in case either the server or the bot crashes, restarts or updates !draw should be used again
panic	3	!panic	Completely shuts down the bot, it won't answer to any server messages This also stops #flatmmo-ingame-chat webhook Only use this as last resort as only Dounford can get it back by restarting the bot

@@ Line 224: / Line 224: @@
 If the prize, or part of it, is not claimed until January 7th it will expire and can be used to any purpose.
+<!--
+=== Auction ===
+AuctionBot is located on Omboko Bank, you can use it to safely trade items
+{| class="wikitable"
+|+
+!COMMAND
+!PERMISSION LEVEL
+!USE
+!DESCRIPTION
+!ALIAS
+|-
+|auction help
+|0
+|!auction help
+|
+|auctionhelp
+|-
+|bid
+|0
+|!bid [amount]
+|Bids on the current auction
+If no amount is specified it will defaults to ['''current bid + minimum increment''']
+"k" and "m" will be converted into 3 and 6 0's respectively
+|b
+|-
+|auction currency
+|0
+|!auction currency <currency>
+|Change the currency used on your Auctions
+Default Currency is Coins
+|auctioncurrency
+|-
+|auction start
+|0
+|!auction start [starting price] [minimum increment] [duration]
+|Starts an Auction, in order for it to happen the auctioned item must be traded with AuctionBot before using the command
+[Starting Price] and [Minimum Increment] defaults to 1
+[Duration] is given in minutes and defaults to 5, the minimum is 1 the max is 10
+Players with permission level 2 or higher can set the duration to 60 minutes
+|auctionstart
+|-
+|auction info
+|0
+|!auction info
+|If an Auction is happening replies with the player that started it, the item and the amount auctioned, the current bid and the minimum increment
+|auctioninfo
+|-
+|auction left
+|0
+|!auction left
+|Replies with the time left before the auction ends
+|auctionleft
+|-
+|auction abort
+|0
+|!auction abort
+|Aborts the current auction in case it was not set correctly
+'''Only the host can use this command'''
+|auctionabort
+|-
+|auction end
+|0
+|!auction end
+|Ends the current auction before the time runs out
+'''Only the host can use this command'''
+|auctionend
+|-
+|auction item
+|0
+|!auction item
+|Replies with the item and amount that the command sender have traded with the Auction Bot
+|auctionitem
+|-
+|auction claim
+|0
+|!auction claim <id>
+|Gets the item bought in the Auction
+In order for the winner to claim the price has to be paid to the AuctionBot, if the winner have traded another item before they need to use !auction takeback, then trade the price then use !auction claim
+After the winner claims the item the host can use !auction claim to get paid
+|auctionclaim
+|-
+|auction switch
+|0
+|!auction switch <auction id> <bid position>
+|Change the auction winner, you can use this in case the winner doesn't want to pay the price
+<Auction Id> is informed as soon as the auction starts
+<bid position> is last to first, default winner would be 0
+'''This can only be used on Auctions not paid yet'''
+'''Only the host can use this command'''
+|auctionswitch
+|-
+|auction takeback
+|0
+|!auction takeback
+|Gets the item you traded back from the bot's inventory
+'''This can't be used while an Auction is taking place'''
+|auctiontakeback
+|-
+|auction cancel
+|0
+|!auction cancel <auction id>
+|Cancel an Auction that already took place, this should be used when the winner doesn't want to pay and other bidders are not interested either
+<Auction Id> is informed as soon as the auction starts
+'''This can only be used on Auctions not paid yet'''
+'''Only the host can use this command'''
+|auctioncancel
+|-
+|auction past
+|0
+|!auction past [id]
+|Same as !auction info but for previous auctions
+|auctionpast
+|}
+-->
 === Moderation ===
 {| class="wikitable"