helpy4/Minecraft-Console-Client
1
0
Fork 0
mirror of https://github.com/MCCTeam/Minecraft-Console-Client synced 2025-10-14 21:22:49 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update README and URLs

Browse source 
Moving to a GitHub organization!
This commit is contained in:
ORelio 2021-10-10 20:56:39 +02:00
parent bb4c13168b
commit 8de7618027
10 changed files with 82 additions and 75 deletions
Download patch file Download diff file Expand all files Collapse all files

2
.github/ISSUE_TEMPLATE/bug_report_form.yaml vendored
View file

@ -11,7 +11,7 @@ body:
options: options:
- label: I made sure I am running the latest [development build](https://ci.appveyor.com/project/ORelio/minecraft-console-client/build/artifacts) - label: I made sure I am running the latest [development build](https://ci.appveyor.com/project/ORelio/minecraft-console-client/build/artifacts)
required: true required: true
- label: I tried to [look for similar issues](https://github.com/ORelio/Minecraft-Console-Client/issues?q=is%3Aissue) before opening a new one - label: I tried to [look for similar issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue) before opening a new one
required: true required: true
- label: I have set `debugmessages=true` in config to diagnose my issue - label: I have set `debugmessages=true` in config to diagnose my issue
required: true required: true

6
.github/ISSUE_TEMPLATE/feature_request_form.yaml vendored
View file

@ -10,11 +10,11 @@ body:
attributes: attributes:
label: Prerequisites label: Prerequisites
options: options:
- label: I have read and understood the [user manual](https://github.com/ORelio/Minecraft-Console-Client/tree/master/MinecraftClient/config) - label: I have read and understood the [user manual](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config)
required: true required: true
- label: I made sure I am running the latest [development build](https://ci.appveyor.com/project/ORelio/minecraft-console-client/build/artifacts) - label: I made sure I am running the latest [development build](https://ci.appveyor.com/project/ORelio/Minecraft-Console-Client/build/artifacts)
required: true required: true
- label: I tried to [look for similar feature requests](https://github.com/ORelio/Minecraft-Console-Client/issues?q=is%3Aissue) before opening a new one - label: I tried to [look for similar feature requests](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue) before opening a new one
required: true required: true
- type: input - type: input
id: client-version id: client-version

2
DebugTools/README.txt
View file

@ -3,4 +3,4 @@ This part of the repository contains tools that may be useful for debugging
MinecraftClientProxy MinecraftClientProxy
A proxy between a MCC/Vanilla client and an offline-mode server which can intercept packets A proxy between a MCC/Vanilla client and an offline-mode server which can intercept packets
Useful to dump packets sent by a Vanilla minecraft client and compare them with packets from MCC Useful to dump packets sent by a Vanilla minecraft client and compare them with packets from MCC
Example of use case: https://github.com/ORelio/Minecraft-Console-Client/issues/195 Example of use case: https://github.com/MCCTeam/Minecraft-Console-Client/issues/195

2
MinecraftClient/ChatBots/AutoCraft.cs
View file

@ -293,7 +293,7 @@ namespace MinecraftClient.ChatBots
"# define slots with their deserved item", "# define slots with their deserved item",
"slot1=Stone # slot start with 1, count from left to right, top to bottom", "slot1=Stone # slot start with 1, count from left to right, top to bottom",
"# For the naming of the items, please see", "# For the naming of the items, please see",
"# https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs" "# https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs"
}; };
File.WriteAllLines(configPath, content); File.WriteAllLines(configPath, content);
} }

4
MinecraftClient/Program.cs
View file

@ -12,7 +12,7 @@ using MinecraftClient.WinAPI;
namespace MinecraftClient namespace MinecraftClient
{ {
/// <summary> /// <summary>
/// Minecraft Console Client by ORelio and Contributors (c) 2012-2020. /// Minecraft Console Client by the MCC Team (c) 2012-2021.
/// Allows to connect to any Minecraft server, send and receive text, automated scripts. /// Allows to connect to any Minecraft server, send and receive text, automated scripts.
/// This source code is released under the CDDL 1.0 License. /// This source code is released under the CDDL 1.0 License.
/// </summary> /// </summary>
@ -43,7 +43,7 @@ namespace MinecraftClient
/// </summary> /// </summary>
static void Main(string[] args) static void Main(string[] args)
{ {
Console.WriteLine("Console Client for MC {0} to {1} - v{2} - By ORelio & Contributors", MCLowestVersion, MCHighestVersion, Version); Console.WriteLine("Minecraft Console Client v{0} - for MC {1} to {2} - Github.com/MCCTeam", Version, MCLowestVersion, MCHighestVersion);
//Build information to facilitate processing of bug reports //Build information to facilitate processing of bug reports
if (BuildInfo != null) if (BuildInfo != null)

4
MinecraftClient/Properties/AssemblyInfo.cs
View file

@ -8,9 +8,9 @@ using System.Runtime.InteropServices;
[assembly: AssemblyTitle("Minecraft Console Client")] [assembly: AssemblyTitle("Minecraft Console Client")]
[assembly: AssemblyDescription("Lightweight console for Minecraft chat and automated scripts")] [assembly: AssemblyDescription("Lightweight console for Minecraft chat and automated scripts")]
//[assembly: AssemblyConfiguration("")] //[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("https://github.com/ORelio/Minecraft-Console-Client")] [assembly: AssemblyCompany("https://github.com/MCCTeam/Minecraft-Console-Client")]
[assembly: AssemblyProduct("MinecraftClient")] [assembly: AssemblyProduct("MinecraftClient")]
[assembly: AssemblyCopyright("Copyright © 2012-2019 ORelio & Contributors")] [assembly: AssemblyCopyright("Copyright © 2012-2021 The MCC Team")]
[assembly: AssemblyTrademark("")] [assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")] [assembly: AssemblyCulture("")]

6
MinecraftClient/Resources/config/MinecraftClient.ini
View file

@ -1,9 +1,9 @@
# Startup Config File # Startup Config File
# New to Minecraft Console Client? See README and sample configuration files here: # New to Minecraft Console Client? See README and sample configuration files here:
# https://github.com/ORelio/Minecraft-Console-Client/tree/master/MinecraftClient/config # https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config
# Want to upgrade to a newer version? See https://github.com/ORelio/Minecraft-Console-Client/#download # Want to upgrade to a newer version? See https://github.com/MCCTeam/Minecraft-Console-Client/#download
# Some settings missing here after an upgrade? Try to delete this file and relaunch MCC to generate a new one # Some settings missing here after an upgrade? Try to delete this file and relaunch MCC to generate a new one
[Main] [Main]
@ -223,7 +223,7 @@ enabled=false
mode=include # include, exclude or everything. Include: drop item IN the list. Exclude: drop item NOT IN the list mode=include # include, exclude or everything. Include: drop item IN the list. Exclude: drop item NOT IN the list
items= # separate each item name with a comma ',': ItemOne,ItemTwo items= # separate each item name with a comma ',': ItemOne,ItemTwo
# See this file for an up-to-date list of item types you can use with this bot: # See this file for an up-to-date list of item types you can use with this bot:
# https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs # https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs
[ReplayMod] [ReplayMod]
# Enable recording of the game (/replay start) and replay it later using the Replay Mod (https://www.replaymod.com/) # Enable recording of the game (/replay start) and replay it later using the Replay Mod (https://www.replaymod.com/)

62
MinecraftClient/config/README.md
View file

@ -16,16 +16,16 @@ On Mac or Linux you need to install the Mono Runtime:
- On Mac: http://www.mono-project.com/download/#download-mac - On Mac: http://www.mono-project.com/download/#download-mac
- On Linux: sudo apt-get install mono-runtime libmono-reflection-cil - On Linux: sudo apt-get install mono-runtime libmono-reflection-cil
Then, open a terminal in this folder and run "mono MinecraftClient.exe". Then, open a terminal in this folder and run "mono MinecraftClient.exe".
If you cannot authenticate on Mono be cause you have TLS/HTTPS/Certificate errors, you'll need to run `mozroots --import --ask-remove` once or install `ca-certificates-mono` (See [#1708](https://github.com/ORelio/Minecraft-Console-Client/issues/1708#issuecomment-893768862)). If you cannot authenticate on Mono be cause you have TLS/HTTPS/Certificate errors, you'll need to run `mozroots --import --ask-remove` once or install `ca-certificates-mono` (See [#1708](https://github.com/MCCTeam/Minecraft-Console-Client/issues/1708#issuecomment-893768862)).
If Mono crashes, retry with `mono-complete` instead of `mono-runtime`. Use at least Mono v4.0. If Mono crashes, retry with `mono-complete` instead of `mono-runtime`. Use at least Mono v4.0.
Using Docker do the following: Using Docker do the following:
```bash ```bash
# Using HTTPS # Using HTTPS
git clone https://github.com/ORelio/Minecraft-Console-Client.git git clone https://github.com/MCCTeam/Minecraft-Console-Client.git
# Using SSH # Using SSH
git clone git@github.com:ORelio/Minecraft-Console-Client.git git clone git@github.com:MCCTeam/Minecraft-Console-Client.git
cd Minecraft-Console-Client/Docker cd Minecraft-Console-Client/Docker
@ -140,7 +140,7 @@ The purpose of this is to give them an easy-to-remember alias and to avoid typin
As what you are typing can be read by the server admin if using the remote control feature, As what you are typing can be read by the server admin if using the remote control feature,
using aliases is really important for privacy and for safely switching between accounts. using aliases is really important for privacy and for safely switching between accounts.
To use these files, simply take a look at [`sample-accounts.txt`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-accounts.txt) and [`sample-servers.txt`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-servers.txt). To use these files, simply take a look at [`sample-accounts.txt`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-accounts.txt) and [`sample-servers.txt`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-servers.txt).
Once you have created your files, fill the `accountlist` and `serverlist` fields in INI file. Once you have created your files, fill the `accountlist` and `serverlist` fields in INI file.
Interacting with the Minecraft world Interacting with the Minecraft world
@ -181,7 +181,7 @@ C# scripts can be used for creating your own ChatBot without recompiling the who
These bots are embedded in a script file, which is compiled and loaded on the fly. These bots are embedded in a script file, which is compiled and loaded on the fly.
ChatBots can access plugin channels for communicating with some server plugins. ChatBots can access plugin channels for communicating with some server plugins.
For knowing everything the API has to offer, you can look at [`CSharpRunner.cs`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/CSharpRunner.cs) and [`ChatBot.cs`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/ChatBot.cs). For knowing everything the API has to offer, you can look at [`CSharpRunner.cs`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/CSharpRunner.cs) and [`ChatBot.cs`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/ChatBot.cs).
The structure of the C# file must be like this: The structure of the C# file must be like this:
```csharp ```csharp
@ -195,11 +195,11 @@ MCC.LoadBot(<instance of your class which extends the ChatBot class>);
``` ```
The first line always needs to be `//MCCScript 1.0` comment, as the program requires it to determine the version of the script. The first line always needs to be `//MCCScript 1.0` comment, as the program requires it to determine the version of the script.
Everything between `//MCCScript 1.0` and `//MCCScript Extensions` comments will be treated as code, that part of the code will be inserted into a class method at compile time. The main part of the script has access to the [`CSharpRunner.cs`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/CSharpRunner.cs) API while the ChatBot defined in the Extensions section will use the [`ChatBot.cs`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/ChatBot.cs) API. Everything between `//MCCScript 1.0` and `//MCCScript Extensions` comments will be treated as code, that part of the code will be inserted into a class method at compile time. The main part of the script has access to the [`CSharpRunner.cs`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/CSharpRunner.cs) API while the ChatBot defined in the Extensions section will use the [`ChatBot.cs`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/ChatBot.cs) API.
You can include standard .NET libraries/namespaces using the following syntax: `//using <name>;`. Example: `//using System.Net;` You can include standard .NET libraries/namespaces using the following syntax: `//using <name>;`. Example: `//using System.Net;`
Some sample scripts and optional Chatbots are made available in the [`config`](https://github.com/ORelio/Minecraft-Console-Client/tree/master/MinecraftClient/config) folder. Some sample scripts and optional Chatbots are made available in the [`config`](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config) folder.
Using HTTP/Socks proxies Using HTTP/Socks proxies
------ ------
@ -232,7 +232,7 @@ Detecting chat messages
Minecraft Console Client can parse messages from the server in order to detect private and public messages. Minecraft Console Client can parse messages from the server in order to detect private and public messages.
This is useful for reacting to messages eg when using the AutoRespond, Hangman game, or RemoteControl bots. This is useful for reacting to messages eg when using the AutoRespond, Hangman game, or RemoteControl bots.
However, for unusual chat formats, so you may need to tinker with the ChatFormat section `MinecraftClient.ini`. This section defines the chat format by the means of regular expressions. Building regular expressions can be a bit tricky, so you might want to try them out eg on https://regex101.com - See also issue [#1640](https://github.com/ORelio/Minecraft-Console-Client/issues/1640) for more explanations on regular expressions. You can test that your MCC instance properly detects chat messages using [`sample-script-with-chatbot.cs`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-script-with-chatbot.cs). However, for unusual chat formats, so you may need to tinker with the ChatFormat section `MinecraftClient.ini`. This section defines the chat format by the means of regular expressions. Building regular expressions can be a bit tricky, so you might want to try them out eg on https://regex101.com - See also issue [#1640](https://github.com/MCCTeam/Minecraft-Console-Client/issues/1640) for more explanations on regular expressions. You can test that your MCC instance properly detects chat messages using [`sample-script-with-chatbot.cs`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-script-with-chatbot.cs).
About Replay Mod feature About Replay Mod feature
------ ------
@ -243,14 +243,14 @@ MCC supports recording and saving your game to a file which can be used by Repla
Using the Alerts bot Using the Alerts bot
------ ------
Write in [`alerts.txt`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/alerts.txt) the words you want the console to beep/alert you on. Write in [`alerts.txt`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/alerts.txt) the words you want the console to beep/alert you on.
Write in [`alerts-exclude.txt`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/alerts-exclude.txt) the words you want NOT to be alerted on. Write in [`alerts-exclude.txt`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/alerts-exclude.txt) the words you want NOT to be alerted on.
For example write `Yourname` in `alerts.txt` and `<Yourname>` in `alerts-exclude.txt` to avoid alerts when you are talking. For example write `Yourname` in `alerts.txt` and `<Yourname>` in `alerts-exclude.txt` to avoid alerts when you are talking.
Using the AutoRelog bot Using the AutoRelog bot
------ ------
Write in [`kickmessages.txt`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/kickmessages.txt) some words, such as `Restarting` for example. Write in [`kickmessages.txt`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/kickmessages.txt) some words, such as `Restarting` for example.
If the kick message contains one of them, you will automatically be re-connected. If the kick message contains one of them, you will automatically be re-connected.
- A kick message `Connection has been lost.` is generated by the console itself when connection is lost. - A kick message `Connection has been lost.` is generated by the console itself when connection is lost.
@ -264,13 +264,13 @@ If you want to always reconnect, set `ignorekickmessage=true` in `MinecraftClien
Using the Script Scheduler / Task Scheduler Using the Script Scheduler / Task Scheduler
------ ------
The script scheduler allows you to perform scripts or internal commands on various events such as log on server, time interval, or fixed date and time. Simply enable the ScriptScheduler bot and specify a tasks file in your INI file. Please read [`sample-tasks.ini`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-tasks.ini) for learning how to make your own task file. The script scheduler allows you to perform scripts or internal commands on various events such as log on server, time interval, or fixed date and time. Simply enable the ScriptScheduler bot and specify a tasks file in your INI file. Please read [`sample-tasks.ini`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-tasks.ini) for learning how to make your own task file.
Using the Hangman game Using the Hangman game
------ ------
Hangman game is one of the first bots ever written for MCC, to demonstrate ChatBot capabilities. Hangman game is one of the first bots ever written for MCC, to demonstrate ChatBot capabilities.
Create a file with words to guess (examples: [`words-en.txt`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/hangman-en.txt), [`words-fr.txt`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/hangman-fr.txt)) and set it in config inside the `[Hangman]` section. Also set `enabled` to `true`. Then, add your username in the `botowners` INI setting, and finally, connect to the server and use `/tell <bot username> start` to start the game. If the bot does not respond to bot owners, see the [Detecting chat messages](#detecting-chat-messages) section. Create a file with words to guess (examples: [`words-en.txt`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/hangman-en.txt), [`words-fr.txt`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/hangman-fr.txt)) and set it in config inside the `[Hangman]` section. Also set `enabled` to `true`. Then, add your username in the `botowners` INI setting, and finally, connect to the server and use `/tell <bot username> start` to start the game. If the bot does not respond to bot owners, see the [Detecting chat messages](#detecting-chat-messages) section.
Using the Remote Control Using the Remote Control
------ ------
@ -278,7 +278,7 @@ Using the Remote Control
When the remote control bot is enabled, you can send commands to your bot using whispers. When the remote control bot is enabled, you can send commands to your bot using whispers.
Don't forget to add your username in the `botowners` INI setting if you want it to obey. Don't forget to add your username in the `botowners` INI setting if you want it to obey.
If it does not respond to bot owners, read the [Detecting chat messages](#detecting-chat-messages) section. If it does not respond to bot owners, read the [Detecting chat messages](#detecting-chat-messages) section.
**Please note that server admins can read what you type and output from the bot. They can also impersonate bot owners with `/nick`, so do not use Remote Control if you do not trust server admins. See [#1142](https://github.com/ORelio/Minecraft-Console-Client/issues/1142) for more info.** **Please note that server admins can read what you type and output from the bot. They can also impersonate bot owners with `/nick`, so do not use Remote Control if you do not trust server admins. See [#1142](https://github.com/MCCTeam/Minecraft-Console-Client/issues/1142) for more info.**
To perform a command simply do the following: `/tell <yourbot> <thecommand>` To perform a command simply do the following: `/tell <yourbot> <thecommand>`
Where `<thecommand>` is an internal command as described in [Internal commands](#internal-commands) section. Where `<thecommand>` is an internal command as described in [Internal commands](#internal-commands) section.
@ -292,7 +292,7 @@ Using the AutoRespond feature
The AutoRespond bot allows you to automatically react on specific chat messages or server announcements. The AutoRespond bot allows you to automatically react on specific chat messages or server announcements.
You can use either a string to detect in chat messages, or an advanced regular expression. You can use either a string to detect in chat messages, or an advanced regular expression.
For more information about how to define match rules, please refer to [`sample-matches.ini`](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-matches.ini). For more information about how to define match rules, please refer to [`sample-matches.ini`](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/config/sample-matches.ini).
See [Detecting chat messages](#detecting-chat-messages) if your messages are not detected or to learn more about regular expressions. See [Detecting chat messages](#detecting-chat-messages) if your messages are not detected or to learn more about regular expressions.
Using the Auto Attack Using the Auto Attack
@ -366,7 +366,7 @@ result=StoneButton # the resulting item
# define slots with their deserved item # define slots with their deserved item
slot1=stone # slot start with 1, count from left to right, top to bottom slot1=stone # slot start with 1, count from left to right, top to bottom
# For the naming of the items, please see # For the naming of the items, please see
# https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs # https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs
``` ```
1. You need to give your recipe a **name** so that you could start them later by name. 1. You need to give your recipe a **name** so that you could start them later by name.
@ -397,7 +397,7 @@ Slots are indexed as follow:
Simply use `slotIndex=MaterialName` to define material. Simply use `slotIndex=MaterialName` to define material.
e.g. `slot1=coal` and `slot3=stick` will craft a torch. e.g. `slot1=coal` and `slot3=stick` will craft a torch.
For the naming of items, please see [ItemType.cs](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs) for all the material names. For the naming of items, please see [ItemType.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs) for all the material names.
After you finished writing your config, you can use `/autocraft start <recipe name>` to start crafting. Make sure to provide materials for your bot by placing them in inventory first. After you finished writing your config, you can use `/autocraft start <recipe name>` to start crafting. Make sure to provide materials for your bot by placing them in inventory first.
@ -417,36 +417,43 @@ License
------ ------
Minecraft Console Client is a totally free of charge, open source project. Minecraft Console Client is a totally free of charge, open source project.
Source code is available at https://github.com/ORelio/Minecraft-Console-Client Source code is available at https://github.com/MCCTeam/Minecraft-Console-Client
Unless specifically stated, source code is from me or contributors, and available under CDDL-1.0. Unless specifically stated, source code is from the MCC Team or Contributors, and available under CDDL-1.0.
More info about CDDL-1.0: http://qstuff.blogspot.fr/2007/04/why-cddl.html More info about CDDL-1.0: http://qstuff.blogspot.fr/2007/04/why-cddl.html
Full license at http://opensource.org/licenses/CDDL-1.0 Full license at http://opensource.org/licenses/CDDL-1.0
Credits Credits
------ ------
Many features would not have been possible without the help of talented contributors: _Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
**Ideas:** Many features would not have been possible without the help of our talented community:
**Maintainers**
ORelio
ReinforceZwei
**Ideas**
ambysdotnet, Awpocalypse, azoundria, bearbear12345, bSun0000, Cat7373, dagonzaros, Dids, ambysdotnet, Awpocalypse, azoundria, bearbear12345, bSun0000, Cat7373, dagonzaros, Dids,
Elvang, fuckofftwice, GeorgH93, initsuj, JamieSinn, joshbean39, LehmusFIN, maski, medxo, Elvang, fuckofftwice, GeorgH93, initsuj, JamieSinn, joshbean39, LehmusFIN, maski, medxo,
mobdon, MousePak, TNT-UP, TorchRJ, yayes2, Yoann166, ZizzyDizzyMC mobdon, MousePak, TNT-UP, TorchRJ, yayes2, Yoann166, ZizzyDizzyMC
**Bug Hunters:** **Bug Hunters**
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, Darkaegis, dbear20, 1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, Darkaegis, dbear20,
DigitalSniperz, doranchak, drXor, FantomHD, gerik43, ibspa, iTzMrpitBull, JamieSinn, DigitalSniperz, doranchak, drXor, FantomHD, gerik43, ibspa, iTzMrpitBull, JamieSinn,
k3ldon, KenXeiko, link3321, lyze237, mattman00000, Nicconyancat, Pokechu22, ridgewell, k3ldon, KenXeiko, link3321, lyze237, mattman00000, Nicconyancat, Pokechu22, ridgewell,
Ryan6578, Solethia, TNT-UP, TorchRJ, TRTrident, WeedIsGood, xp9kus, Yoann166 Ryan6578, Solethia, TNT-UP, TorchRJ, TRTrident, WeedIsGood, xp9kus, Yoann166
**Code contributions:** **Contributors**
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch,
initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22,
ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC
And all the [GitHub contributors](https://github.com/ORelio/Minecraft-Console-Client/graphs/contributors)! _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
**Libraries:** **Libraries:**
@ -463,9 +470,10 @@ Many features would not have been possible without the help of talented contribu
If you still have any question after reading this file, you can get support here: If you still have any question after reading this file, you can get support here:
- GitHub Issues: https://github.com/ORelio/Minecraft-Console-Client/issues (You can contact the MCC team here) - GitHub Issues: https://github.com/MCCTeam/Minecraft-Console-Client/issues (You can contact the MCC Team here)
- Minecraft Forums: http://www.minecraftforum.net/topic/1314800-/ (Thead not maintained by the MCC team anymore) - Minecraft Forums: http://www.minecraftforum.net/topic/1314800-/ (Thead not maintained by the MCC Team anymore)
Code contributions, bug reports and any kind of comments are also highly appreciated :) Code contributions, bug reports and any kind of comments are also highly appreciated :)
_© 2012-2021 ORelio & Contributors_ _© 2012-2020 ORelio_
_© 2020-2021 The MCC Team_

6
README-zh-Hans.md
View file

@ -10,7 +10,7 @@
## 正在寻找维护者 ## 正在寻找维护者
由于不再有足够的时间来为新的我的世界版本提供升级和修复错误，开发者正在寻找有开发动力的人来接手该项目。如果您认为您可以接手该项目，请查看 [issues](https://github.com/ORelio/Minecraft-Console-Client/issues?q=is%3Aissue+is%3Aopen+label%3Awaiting-for%3Acontributor) 部分 :) 由于不再有足够的时间来为新的我的世界版本提供升级和修复错误，开发者正在寻找有开发动力的人来接手该项目。如果您认为您可以接手该项目，请查看 [issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+is%3Aopen+label%3Awaiting-for%3Acontributor) 部分 :)
## 下载 ## 下载
@ -24,9 +24,9 @@
## 从原代码编译 ## 从原代码编译
首先，下载[原代码zip压缩包](https://github.com/ORelio/Minecraft-Console-Client/archive/master.zip)，将其解压并进入`MinecraftClient`文件夹 首先，下载[原代码zip压缩包](https://github.com/MCCTeam/Minecraft-Console-Client/archive/master.zip)，将其解压并进入`MinecraftClient`文件夹
编辑 `MinecraftClient.csproj` 的[第四行](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/MinecraftClient.csproj#L4)，将编译目标设置为 `Release`: 编辑 `MinecraftClient.csproj` 的[第四行](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/MinecraftClient.csproj#L4)，将编译目标设置为 `Release`:
```xml ```xml
<Configuration Condition=" '$(Configuration)' == '' ">Release</Configuration> <Configuration Condition=" '$(Configuration)' == '' ">Release</Configuration>

63
README.md
View file

@ -3,65 +3,64 @@ Minecraft Console Client
[![Appveyor build status](https://ci.appveyor.com/api/projects/status/github/ORelio/Minecraft-Console-Client?branch=Indev)](https://ci.appveyor.com/project/ORelio/minecraft-console-client) [![Appveyor build status](https://ci.appveyor.com/api/projects/status/github/ORelio/Minecraft-Console-Client?branch=Indev)](https://ci.appveyor.com/project/ORelio/minecraft-console-client)
Minecraft Console Client(MCC) is a lightweight app allowing you to connect to any Minecraft server, Minecraft Console Client (MCC) is a lightweight app allowing you to connect to any Minecraft server, send commands and receive text messages in a fast and easy way without having to open the main Minecraft game. It also provides various automations that you can enable for administration and other purposes.
send commands and receive text messages in a fast and easy way without having to open the main Minecraft game. It also provides various automation for administration and other purposes.
## Looking for maintainers ## Download 🔽
Due to no longer having time to implement upgrades for new Minecraft versions and fixing bugs, I'm looking for motivated people to take over the project. If you feel like it could be you, please have a look at the [issues](https://github.com/ORelio/Minecraft-Console-Client/issues?q=is%3Aissue+is%3Aopen+label%3Awaiting-for%3Acontributor) section :) Get binary file from our latest [development build](https://ci.appveyor.com/project/ORelio/minecraft-console-client/build/artifacts).
The exe file is a .NET binary which also works on Mac and Linux.
## Download ## How to use 📚
Get exe file from the latest [development build](https://ci.appveyor.com/project/ORelio/minecraft-console-client/build/artifacts). Check out the [sample configuration files](MinecraftClient/config/) which includes the how-to-use [README](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config#minecraft-console-client-user-manual).
This exe file is a .NET binary which also works on Mac and Linux.
## How to use ## Getting Help 🙋
Check out the [sample configuration files](MinecraftClient/config/) which includes the how-to-use README. Check out the [README](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config#minecraft-console-client-user-manual) and existing [Discussions](https://github.com/MCCTeam/Minecraft-Console-Client/discussions): Maybe your question is answered there. If not, please open a [New Discussion](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/new) and ask your question. If you find a bug, please report it in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section.
Help and more info is also available on the [Minecraft Forum thread](http://www.minecraftforum.net/topic/1314800-/).<br/>
## Getting Help ## Helping Us ❤️
Check out the [README](MinecraftClient/config/) and existing [Discussions](https://github.com/ORelio/Minecraft-Console-Client/discussions): Maybe your question is answered there. If not, please open a [New Discussion](https://github.com/ORelio/Minecraft-Console-Client/discussions/new) and ask your question. **Please do not ask questions in the Issues section**, that's for bug reports and feature requests. We are a small community so we need help to implement upgrades for new Minecraft versions, fixing bugs and expanding the project. We are always looking for motivated people to contribute. If you feel like it could be you, please have a look at the [issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+is%3Aopen+label%3Awaiting-for%3Acontributor) section :)
## Building from source ## How to contribute 📝
First of all, get a [zip of source code](https://github.com/ORelio/Minecraft-Console-Client/archive/master.zip), extract it and navigate to the `MinecraftClient` folder. If you'd like to contribute to Minecraft Console Client, great, just fork the repository and submit a pull request on the *Master* branch. MCC is currently distributed as development builds only (which are usually stable) so we no longer use the *Indev* branch.
Edit `MinecraftClient.csproj` to set the Build target to `Release` on [line 4](https://github.com/ORelio/Minecraft-Console-Client/blob/master/MinecraftClient/MinecraftClient.csproj#L4): ## Translating Minecraft Console Client 🌍
If you would like to translate Minecraft Console Client to a different language, please download the translation file from [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang) or just fork the repository. Once you finished the translation work, submit a pull request or send us the file through an [Issue](https://github.com/MCCTeam/Minecraft-Console-Client/issues) in case you are not familiar with Git.
To use the translated language file, place it under `lang/mcc/` folder and set your language in `.ini` config. You may create the directory if does not exist.
For the names of the translation file, please see [this comment](https://github.com/MCCTeam/Minecraft-Console-Client/pull/1282#issuecomment-711150715).
## Building from source 🏗️
_The recommended development environment is [Visual Studio](https://visualstudio.microsoft.com/). If you want to build the project without installing a development environment, you may also follow these instructions:_
First of all, get a [zip of source code](https://github.com/MCCTeam/Minecraft-Console-Client/archive/master.zip), extract it and navigate to the `MinecraftClient` folder.
Edit `MinecraftClient.csproj` to set the Build target to `Release` on [line 4](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/MinecraftClient.csproj#L4):
```xml ```xml
<Configuration Condition=" '$(Configuration)' == '' ">Release</Configuration> <Configuration Condition=" '$(Configuration)' == '' ">Release</Configuration>
``` ```
### On Windows ### On Windows 🪟
1. Locate `MSBuild.exe` for .NET 4 inside `C:\Windows\Microsoft.NET\Framework\v4.X.XXXXX` 1. Locate `MSBuild.exe` for .NET 4 inside `C:\Windows\Microsoft.NET\Framework\v4.X.XXXXX`
2. Drag and drop `MinecraftClient.csproj` over `MSBuild.exe` to launch the build 2. Drag and drop `MinecraftClient.csproj` over `MSBuild.exe` to launch the build
3. If the build succeeds, you can find `MinecraftClient.exe` under `MinecraftClient\bin\Release` 3. If the build succeeds, you can find `MinecraftClient.exe` under `MinecraftClient\bin\Release`
### On Mac and Linux ### On Mac and Linux 🐧
1. Install the [Mono Framework](https://www.mono-project.com/download/stable/#download-lin) if not already installed 1. Install the [Mono Framework](https://www.mono-project.com/download/stable/#download-lin) if not already installed
2. Run `msbuild MinecraftClient.csproj` in a terminal 2. Run `msbuild MinecraftClient.csproj` in a terminal
3. If the build succeeds, you can find `MinecraftClient.exe` under `MinecraftClient\bin\Release` 3. If the build succeeds, you can find `MinecraftClient.exe` under `MinecraftClient\bin\Release`
## How to contribute ## License ⚖️
If you'd like to contribute to Minecraft Console Client, great, just fork the repository and submit a pull request. The *Indev* branch for contributions to future stable versions is no longer used as MCC is currently distributed as development builds only. Unless specifically stated, the code is from the MCC Team or Contributors, and available under CDDL-1.0. Else, the license and original author are mentioned in source file headers.
## Translate Minecraft Console Client to your language
If you would like to translate Minecraft Console Client to a different language, please download the translation file from [the repository](https://github.com/ORelio/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang) or just fork the repository. Once you finished the translation work, submit a pull request or send us the file in case you did not fork the repository.
To use the translated language file, place it under `lang/mcc/` folder and set your language in `.ini` config. You may create the directory if does not exist.
For the names of the translation file, please see [this comment](https://github.com/ORelio/Minecraft-Console-Client/pull/1282#issuecomment-711150715).
## License
Unless specifically stated, the code is from the MCC developers, and available under CDDL-1.0.
Else, the license and original author are mentioned in source file headers.
The main terms of the CDDL-1.0 license are basically the following: The main terms of the CDDL-1.0 license are basically the following:
- You may use the licensed code in whole or in part 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. - You may use the licensed code in whole or in part 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.