Have you ever been annoyed by having to run Minecraft just to type a command? Or high memory usage just because you have multiple Minecraft windows opened?
Minecraft Console Client is a lightweight app that will make your life easier! Able to connect to any minecraft server, both offline and online mode, it enables you to send commands and receive text messages in a fast and easy way without having to open the main Minecraft game.
But that's not all! Through various automation that can be enabled using the configuration file such as an anti-AFK system and alerts on specific words, this client is useful for server adminstration and automated scripts! Using the source code, you can even create a chatbot using the built-in API!
System requirements :
Windows XP or higher with .NET framework v4.0 or greater (download link)
Mac or Linux with Mono framework, v4.0-4.2 is recommended (download link)
Features :
Uses only 10MB of RAM!
Supports both online-mode and offline-mode
Send text messages and commands to the server
Receive messages from server with text coloring!
Command-line usage for automated scripts (batch...)
Terrain handling : fall to ground, walk around, pick up items
Built-in bots: Alerts, AntiAFK, AutoRelog, Log, Hangman game
Easy to use C# scripting API for making your own scripts and bots
Usage :
Download the app, unzip the archive and run it.
Enter the username, password ("-" for offline mode) and server IP to connect.
• Auto-connect : MinecraftClient.exe username password server
This will automatically connect you to the chosen server.
• Single command usage : MinecraftClient.exe username password server "/mycommand"
This will automatically send "/mycommand" to the server, and then the client will automatically leave the server and close.
Useful for use in batch command sending scripts.
Protip™ : Don't want to specify the password, username and/or server ?
Juste write "" instead in the command-line, and you'll have to enter them manually.
Command-lines for versions lower than 1.6.0 :
For version 1.6.0 or newer use INI files instead!
• Auto-connect with bot loading : MinecraftClient.exe username password server bot:botname
Available bots : alerts, antiafk, hangman, pendu (hangman in french)
You will still be able to send and receive chat messages when a bot is loaded.
• Auto-connect with multiple bot loading :
MinecraftClient.exe username password server bot:botname bot:botname bot:botname (etc.)
How to use the bots :
All bots are disabled by default. To enable/use a bot please read the following :
To load a bot, please use the "Auto-connect with bot loading" command-line described above.
If you are using MCC 1.6.0 or newer, simply edit the INI configuration file and you're done!
An updated guide with explanations relevant to your version can be found in README file.
Below are the instructions for versions lower than 1.6.0
AnfiAFK : sends a /ping command every 60 seconds in order to stay non-AFK.
Just load it with the bot:antiafk argument and you're done! You can configure the time between each /ping with bot:antiafk:time (10 = 1 second ; 600 = 1 minute etc. Time can't be less than 10. Example : bot:antiafk:600)
Hangman : A game in wich the players have to discover a word.
Loaded with the bot:hangman argument. How to start the game : Send a "start" private message to the bot (/tell <botname> start)
The bot only obeys to the Console and usernames written in bot-owners.txt.
You can stop the game at any moment with /tell <botname> stop
How to play : Just provide some letters in the chat, in a single-letter message.
The game will end if no letter has been tried for 5 minutes, or if there is no more lives left.
How to add or remove words : Just edit words.txt, one word per line.
words.txt already contains 15 words (sample, minecraft-related). If you don't use the hangman bot, you can safely delete bot-owners.txt, words.txt, mots.txt.
Pendu : The same game as hangman, but in french. Loaded with the bot:pendu argument.
Words are stored in a different file (mots.txt) but apart from this, it works the same way. As I am french I already added 322 words in the french file version.
Alerts : This bot alerts you on configurable words that appear in the chat, and highlight them.
Words can be configured in alerts.txt. One word per line, case insensitive.
If you wish not to be alerted on some other words, provide them in alerts-exclude.txt.
Eg Yourname to alerts.txt and Yourname> to alerts-exclude.txt, to avoid beeps when you are talking.
The two files contain some sample words for easily getting started.
Use the bot:alerts argument to load the bot. If you don't use the Alerts bot, you can safely delete alerts.txt and alerts-exclude.txt.
Log : Writes chat messages in a file (chat-<servername>.log) with date and time for each message.
Just load it with the bot:log argument. You can configure some filters : bot:log:all -> All the received text will be saved
bot:log:messages -> Public messages and whispers (/tell) are saved [default]
bot:log:chat -> Only chat messages are saved
bot:log:private -> Only whispers (/tell) are saved
AutoRelog : Automatically re-join the server on user-defined kick messages.
Edit kickmessages.txt to specify which words in kick messages will trigger a reconnect, one per line.
Eg if typing "restarting" in the file, the console will reconnect for "Server is restarting!" kick message.
Note: A "Connection has been lost" kick message is generated when connection is lost.
Once the file is ready, load the bot using bot:autorelog argument and you're done!
You may specify a delay in seconds before re-joining, and amount of reconnect attempt if the first one fails.
Eg bot:autorelog:30:5 for 30 seconds & 5 attempts. (default: 10 & 3). -1 stands for unfinite attempts.
If you don't use the AutoRelog bot, you can safely delete kickmessages.txt.
Credits :
I used the following documentation to write this program :
Also, early versions of this project used parts of code written by gamer931215 and available here. He wrote a client class for offline mode servers running minecraft 1.0 which helped me a lot getting started.
Finally, even though I'm the main author of Minecraft Console Client, many features would not have been possible without the help of talented contributors :
Disclaimer : Even if everything should work, I am not responsible of any damage this app could cause to your computer or your server. This app does not steal your password. If you don't trust it, don't use it or check & compile the source code. Also, remember that when you connect to a server with this program, you will appear where you left the last time, so you can die if you log in in an unsafe place on a survival server.
Nice work,
But i don't understand why somebody would need this you can't build. But it uses less ram and if you want to just chat and not use up your cpu this is great
I hope you have success with this
- You may use the licensed code in whole (the entire program) or in part (individual source files, functions, or methods) in any program you desire, regardless of the license of the program as a whole (or rather, as excluding the code you are borrowing). The program itself may be open or closed source, free or commercial.
- However, in all cases, any modifications, improvements, or additions to the CDDL code (any code that is referenced in direct modifications to the CDDL code is considered an addition to the CDDL code, and so is bound by this requirement; e.g. a modification of a math function to use a fast lookup table makes that table itself an addition to the CDDL code, regardless of whether it's in a source code file of its own) must be made publicly and freely available in source, under the CDDL license itself.
- In any program (source or binary) that uses CDDL code, recognition must be given to the source (either project or author) of the CDDL code. As well, modifications to the CDDL code (which must be distributed as source) may not remove notices indicating the ancestry of the code.
-- http://qstuff.blogsp...4/why-cddl.html
Thanks for your feedback! I mainly use this to chat on a server while playing on another one, or just doing anything else than playing minecraft
thanks for appreciating my comment but i think i will use this alot because alot of times i log on my server just to say hi and do a few commandsbut minecraft will use up my memory so this makes my pc faster so thanks so much for this software also i am an experienced web developer with php and css so if you need help making a project website for this just ask me i can do it for free because of this masterpiece you gave to the community.
Thank you for this offer, although for the moment I do not consider making a website.
I am pleased to see that someone found my program so useful that he calls it a masterpiece!
This motivates me a lot and I will keep improving it. The last days I fixed some bugs, added a Bot API including a hangman game that can be played on any server. Released today in version 1.1. Yay !
New update !
> The program can handle multiple bots at the same time
> Improved the AntiAFK bot : You can specify a custom amount of time between each /ping
> New bot : Alerts ! It beeps on words you specify in a file and highlight them in the chat.
Error: Connexion lost.
Fix: Connection lost.
-------------------------------------------------------------------------------------------------------
I also get this error whenever i run it:
Log:
Sorry for the spelling mistakes, and thanks for pointing that out. Fixes will be included in the next release.
The app should work with Mono but I haven't tried so I cannot guarantee that it works on Mac or Linux
The "Network Error" is raised when a WebException is catched in GetLogin() in MinecraftCom.cs. This means that the webclient contained in the .NET framework couldn't retrieve the answer from Minecraft.net.
https might not be supported in Mono's WebClient, this would explain the error you are getting.
You could try to modify the URL from https to http in the source code, but it wouldn't be secure to send the password without any encryption.
Check out this EPIC game VoidSpace, a Work-In-Progress, cross-platform universe MMO. I'm more excited for this game than I am for everything else... except CIV: Beyond Earth http://strt.cc?r=ZGFob29wc0BsaXZlLmNvbQ__
Works great. Occasionally it doesn't catch messages though (as in I'll type something, but not see myself say it aside from the echo while everyone else does, or someone says something and I don't see it). Also, could you put in a limit on message length, so we don't accidentally send too long a string and get kicked? Either crop it, or for strings that don't start with '/' break into multiple sends.
I noticed those missing messages but I don't know exactly why they are missing. I think it's due to my packet analysis function MinecraftCom.Update() which is not 100% accurate...
Thank you for the feedback, I will improve the message sending to split too longs messages and crop too long commands, nice idea.
New Update !
> Added a new bot: Log! It writes chat messages in a file with date and time for each message
> Created a class allowing simultaneous console input and output without breaking user input
> Fixed a spelling mistake (connexion -> connection) - thanks to bearbear12345
> Too long messages are splitted into several messages - thanks to Elvang for the idea
The # key doesn't works for you ? I don't have a qwerty keyboard to try it out, but on my azerty keyboard it works well.
Wich encryption ? When MC 1.3 will be out, i'll wait for http://wiki.vg/Protocol to be updated and adapt my program.
Remember that when doing this you send your password unencrypted, beware! Someone on your network could easily catch it!
Section 1) What i meant was that because my password contains a #, when the client recieves it, since it is sent to a server, the server interprets the # as a page anchor.
Like on firefox/ie/chrome/opera/etc if I type in the link:
The # key doesn't works for you ? I don't have a qwerty keyboard to try it out, but on my azerty keyboard it works well.
Wich encryption ? When MC 1.3 will be out, i'll wait for http://wiki.vg/Protocol to be updated and adapt my program.
Remember that when doing this you send your password unencrypted, beware! Someone on your network could easily catch it!
Section 1) What i meant was that because my password contains a #, when the client recieves it, since it is sent to a server, the server interprets the # as a page anchor.
Like on firefox/ie/chrome/opera/etc if I type in the link:
Have you ever been annoyed by having to run Minecraft just to type a command? Or high memory usage just because you have multiple Minecraft windows opened?
Minecraft Console Client is a lightweight app that will make your life easier! Able to connect to any minecraft server, both offline and online mode, it enables you to send commands and receive text messages in a fast and easy way without having to open the main Minecraft game.
But that's not all! Through various automation that can be enabled using the configuration file such as an anti-AFK system and alerts on specific words, this client is useful for server adminstration and automated scripts! Using the source code, you can even create a chatbot using the built-in API!
System requirements :
Features :
Usage :
Development Builds
Older stable versions and changelog :
v1.7.3 for Minecraft 1.7.2 to 1.7.9 :
All the downloads are provided under CDDL-1.0.
Command-Line usage :
• Auto-connect : MinecraftClient.exe username password server
This will automatically connect you to the chosen server.
• Single command usage : MinecraftClient.exe username password server "/mycommand"
This will automatically send "/mycommand" to the server, and then the client will automatically leave the server and close.
Useful for use in batch command sending scripts.
Protip™ : Don't want to specify the password, username and/or server ?
Juste write "" instead in the command-line, and you'll have to enter them manually.
Command-lines for versions lower than 1.6.0 :
• Auto-connect with bot loading : MinecraftClient.exe username password server bot:botname
Available bots : alerts, antiafk, hangman, pendu (hangman in french)
You will still be able to send and receive chat messages when a bot is loaded.
• Auto-connect with multiple bot loading :
MinecraftClient.exe username password server bot:botname bot:botname bot:botname (etc.)
How to use the bots :
All bots are disabled by default. To enable/use a bot please read the following :
If you are using MCC 1.6.0 or newer, simply edit the INI configuration file and you're done!
An updated guide with explanations relevant to your version can be found in README file.
Below are the instructions for versions lower than 1.6.0
AnfiAFK : sends a /ping command every 60 seconds in order to stay non-AFK.
Just load it with the bot:antiafk argument and you're done! You can configure the time between each /ping with bot:antiafk:time (10 = 1 second ; 600 = 1 minute etc. Time can't be less than 10. Example : bot:antiafk:600)
Hangman : A game in wich the players have to discover a word.
Loaded with the bot:hangman argument.
How to start the game :
Send a "start" private message to the bot (/tell <botname> start)
The bot only obeys to the Console and usernames written in bot-owners.txt.
You can stop the game at any moment with /tell <botname> stop
How to play :
Just provide some letters in the chat, in a single-letter message.
The game will end if no letter has been tried for 5 minutes, or if there is no more lives left.
How to add or remove words :
Just edit words.txt, one word per line.
words.txt already contains 15 words (sample, minecraft-related).
If you don't use the hangman bot, you can safely delete bot-owners.txt, words.txt, mots.txt.
Pendu : The same game as hangman, but in french. Loaded with the bot:pendu argument.
Words are stored in a different file (mots.txt) but apart from this, it works the same way.
As I am french I already added 322 words in the french file version.
Alerts : This bot alerts you on configurable words that appear in the chat, and highlight them.
Words can be configured in alerts.txt. One word per line, case insensitive.
If you wish not to be alerted on some other words, provide them in alerts-exclude.txt.
Eg Yourname to alerts.txt and Yourname> to alerts-exclude.txt, to avoid beeps when you are talking.
The two files contain some sample words for easily getting started.
Use the bot:alerts argument to load the bot.
If you don't use the Alerts bot, you can safely delete alerts.txt and alerts-exclude.txt.
Log : Writes chat messages in a file (chat-<servername>.log) with date and time for each message.
Just load it with the bot:log argument. You can configure some filters :
bot:log:all -> All the received text will be saved
bot:log:messages -> Public messages and whispers (/tell) are saved [default]
bot:log:chat -> Only chat messages are saved
bot:log:private -> Only whispers (/tell) are saved
AutoRelog : Automatically re-join the server on user-defined kick messages.
Edit kickmessages.txt to specify which words in kick messages will trigger a reconnect, one per line.
Eg if typing "restarting" in the file, the console will reconnect for "Server is restarting!" kick message.
Note: A "Connection has been lost" kick message is generated when connection is lost.
Once the file is ready, load the bot using bot:autorelog argument and you're done!You may specify a delay in seconds before re-joining, and amount of reconnect attempt if the first one fails.
If you don't use the AutoRelog bot, you can safely delete kickmessages.txt.Eg bot:autorelog:30:5 for 30 seconds & 5 attempts. (default: 10 & 3). -1 stands for unfinite attempts.
Credits :
I used the following documentation to write this program :
Some parts of code were taken from the following projects :
Also, early versions of this project used parts of code written by gamer931215 and available here. He wrote a client class for offline mode servers running minecraft 1.0 which helped me a lot getting started.
Finally, even though I'm the main author of Minecraft Console Client, many features would not have been possible without the help of talented contributors :
Ideas : ambysdotnet, Awpocalypse, azoundria, bearbear12345, bSun0000, Cat7373, dagonzaros, Dids, Elvang, fuckofftwice, GeorgH93, initsuj, JamieSinn, joshbean39, LehmusFIN, maski, medxo, mobdon, MousePak, TNT-UP, TorchRJ, yayes2, Yoann166, ZizzyDizzyMC. Bug Hunters : 1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Darkaegis, dbear20, DigitalSniperz, doranchak, drXor, FantomHD, gerik43, ibspa, iTzMrpitBull, JamieSinn, k3ldon, KenXeiko, link3321, lyze237, mattman00000, Nicconyancat, Pokechu22, ridgewell, Ryan6578, Solethia, TNT-UP, TorchRJ, TRTrident, WeedIsGood, xp9kus, Yoann166. Code contributions : Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, Pokechu22, TheMeq, v1RuX, ZizzyDizzyMC.
hank you very much for your contributions. You are awesome!
Also see code contributions graph on GitHub.
Buy me a coffee?
I've spent countless hours working on this project during several years. If MCC is useful to you, you might want to contribute to its development:
Code contributions, bug reports and any kind of comments are also highly appreciated
Other cool stuff you might be interested in: Minecraft Server Dashboard by bearbear12345
Disclaimer : Even if everything should work, I am not responsible of any damage this app could cause to your computer or your server. This app does not steal your password. If you don't trust it, don't use it or check & compile the source code. Also, remember that when you connect to a server with this program, you will appear where you left the last time, so you can die if you log in in an unsafe place on a survival server.
But i don't understand why somebody would need this you can't build. But it uses less ram and if you want to just chat and not use up your cpu this is great
I hope you have success with this
http://wiki.creativecommons.org/FAQ#Can_I_apply_a_Creative_Commons_license_to_software.3F
http://www.opensourc...censes/CDDL-1.0
thanks for appreciating my comment but i think i will use this alot because alot of times i log on my server just to say hi and do a few commandsbut minecraft will use up my memory so this makes my pc faster so thanks so much for this software also i am an experienced web developer with php and css so if you need help making a project website for this just ask me i can do it for free because of this masterpiece you gave to the community.
I am pleased to see that someone found my program so useful that he calls it a masterpiece!
This motivates me a lot and I will keep improving it. The last days I fixed some bugs, added a Bot API including a hangman game that can be played on any server. Released today in version 1.1. Yay !
> The program can handle multiple bots at the same time
> Improved the AntiAFK bot : You can specify a custom amount of time between each /ping
> New bot : Alerts ! It beeps on words you specify in a file and highlight them in the chat.
Would this work on linux?
Or would i use mono?
File: Program.cs
Line: 50
Error: Connexion failed : Network error.
Fix: Connection failed : Network error.
File: MinecraftCom.cs
Line: 272
Error: Connexion lost.
Fix: Connection lost.
-------------------------------------------------------------------------------------------------------
I also get this error whenever i run it:
Log:
But when I copy that link into my browser and fill in the password, it works.
Why does it say Network error?
The app should work with Mono but I haven't tried so I cannot guarantee that it works on Mac or Linux
The "Network Error" is raised when a WebException is catched in GetLogin() in MinecraftCom.cs. This means that the webclient contained in the .NET framework couldn't retrieve the answer from Minecraft.net.
https might not be supported in Mono's WebClient, this would explain the error you are getting.
You could try to modify the URL from https to http in the source code, but it wouldn't be secure to send the password without any encryption.
http://strt.cc?r=ZGFob29wc0BsaXZlLmNvbQ__
Thank you for the feedback, I will improve the message sending to split too longs messages and crop too long commands, nice idea.
> Added a new bot: Log! It writes chat messages in a file with date and time for each message
> Created a class allowing simultaneous console input and output without breaking user input
> Fixed a spelling mistake (connexion -> connection) - thanks to bearbear12345
> Too long messages are splitted into several messages - thanks to Elvang for the idea
If anyone else wants it:
Link [Direct]
The # key doesn't works for you ? I don't have a qwerty keyboard to try it out, but on my azerty keyboard it works well.
Wich encryption ? When MC 1.3 will be out, i'll wait for http://wiki.vg/Protocol to be updated and adapt my program.
Remember that when doing this you send your password unencrypted, beware! Someone on your network could easily catch it!
Section 1) What i meant was that because my password contains a #, when the client recieves it, since it is sent to a server, the server interprets the # as a page anchor.
Like on firefox/ie/chrome/opera/etc if I type in the link:
The server/client/whatever-it-is thinks that i want to go to the &version=13 anchor, which would then lead to a bad request
Section 3) Then how can i make it work with mono?
Section 1) What i meant was that because my password contains a #, when the client recieves it, since it is sent to a server, the server interprets the # as a page anchor.
Like on firefox/ie/chrome/opera/etc if I type in the link:
The server/client/whatever-it-is thinks that i want to go to the &version=13 anchor, which would then lead to a bad request
Section 3) Then how can i make it work with mono?