mirror of
https://github.com/MCCTeam/Minecraft-Console-Client
synced 2025-10-14 21:22:49 +00:00
New translation update from Crowdin (#2318)
This commit is contained in:
BruceChen
GitHub
parent
4341304c05
commit
524dbea8fc
284 changed files with 158096 additions and 720 deletions
|
|
@ -119,7 +119,7 @@
|
|||
</resheader>
|
||||
<data name="Container.BrewingStand" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Brewing Stand ║
|
||||
║ Brūvēšanas statīvs ║
|
||||
║ ╔═══╗ ⡈ ⠄╔═══╗ ║
|
||||
║ ║ 4 ╟───╮ ⢠⡐⢈║ 3 ║ ┃ ║
|
||||
║ ╚═══╝ ╭─╯ ⠂⡠⢂╚╦╦╦╝ ┃ ║
|
||||
|
|
@ -127,7 +127,7 @@
|
|||
║ ╔═══╦═╝║╚═╦═══╗ ║
|
||||
║ ║ 0 ║╔═╩═╗║ 2 ║ ║
|
||||
║ ╚═══╝║ 1 ║╚═══╝ ║
|
||||
║ Inventory ╚═══╝ ║
|
||||
║ Inventārs ╚═══╝ ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║12 ║13 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -143,7 +143,7 @@
|
|||
</data>
|
||||
<data name="Container.Crafting" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Crafting ║
|
||||
║ Amatniecība ║
|
||||
║ ╔═══╦═══╦═══╗ ║
|
||||
║ ║ 1 ║ 2 ║ 3 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ╔═══╗ ║
|
||||
|
|
@ -151,7 +151,7 @@
|
|||
║ ╠═══╬═══╬═══╣ ╚═══╝ ║
|
||||
║ ║ 7 ║ 8 ║ 9 ║ ║
|
||||
║ ╚═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║10 ║11 ║12 ║13 ║14 ║15 ║16 ║17 ║18 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -167,31 +167,31 @@
|
|||
</data>
|
||||
<data name="Container.EnchantingTable" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Enchant ║
|
||||
║ ╔════════════════════╗ ║
|
||||
║ ║ Top ║ ║
|
||||
║ ╔═══╦═══╗ ╠════════════════════╣ ║
|
||||
║ ║ 0 ║ 1 ║ ║ Middle ║ ║
|
||||
║ ╚═══╩═══╝ ╠════════════════════╣ ║
|
||||
║ ║ Bottom ║ ║
|
||||
║ ╚════════════════════╝ ║
|
||||
║ Inventory ║
|
||||
║ Amatniecība ║
|
||||
║ ╔═══╦═══╦═══╗ ║
|
||||
║ ║ 1 ║ 2 ║ 3 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ╔═══╗ ║
|
||||
║ ║ 4 ║ 5 ║ 6 ║ ━━▶ ║ 0 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ╚═══╝ ║
|
||||
║ ║ 7 ║ 8 ║ 9 ║ ║
|
||||
║ ╚═══╩═══╩═══╝ ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║║
|
||||
║║10 ║11 ║12 ║13 ║14 ║15 ║16 ║17 ║18 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║11 ║12 ║13 ║14 ║15 ║16 ║17 ║18 ║19 ║║
|
||||
║║19 ║20 ║21 ║22 ║23 ║24 ║25 ║26 ║27 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║20 ║21 ║22 ║23 ║24 ║25 ║26 ║27 ║28 ║║
|
||||
║║28 ║29 ║30 ║31 ║32 ║33 ║34 ║35 ║36 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║29 ║30 ║31 ║32 ║33 ║34 ║35 ║36 ║37 ║║
|
||||
║║37 ║38 ║39 ║40 ║41 ║42 ║43 ║44 ║45 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║ 1 2 3 4 5 6 7 8 9 ║
|
||||
╚═════════════════════════════════════╝</value>
|
||||
</data>
|
||||
<data name="Container.Furnace" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Krāsns ║
|
||||
║ ╔═══╗ ║
|
||||
║ ║ 0 ║ ║
|
||||
║ ╚═══╝ ╔═══╗ ║
|
||||
|
|
@ -200,7 +200,7 @@
|
|||
║ ╔═══╗ ║
|
||||
║ ║ 1 ║ ║
|
||||
║ ╚═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -216,7 +216,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_3x3" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Amatniecība ║
|
||||
║ ╔═══╦═══╦═══╗ ║
|
||||
║ ║ 0 ║ 1 ║ 2 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ║
|
||||
|
|
@ -224,7 +224,7 @@
|
|||
║ ╠═══╬═══╬═══╣ ║
|
||||
║ ║ 6 ║ 7 ║ 8 ║ ║
|
||||
║ ╚═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 9 ║10 ║11 ║12 ║13 ║14 ║15 ║16 ║17 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -240,7 +240,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_9x3" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Lāde ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -248,7 +248,7 @@
|
|||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║18 ║19 ║20 ║21 ║22 ║23 ║24 ║25 ║26 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║ Inventory ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║27 ║28 ║29 ║30 ║31 ║32 ║33 ║34 ║35 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -264,7 +264,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_9x6" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Lielā lāde ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -278,7 +278,7 @@
|
|||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║45 ║46 ║47 ║48 ║49 ║50 ║51 ║52 ║53 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║ Inventory ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║54 ║55 ║56 ║57 ║58 ║59 ║60 ║61 ║62 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -294,7 +294,7 @@
|
|||
</data>
|
||||
<data name="Container.Grindstone" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Repair & Disenchant ║
|
||||
║ Salabot un noņemt uzlabojumus ║
|
||||
║ ╔═════════╗ ║
|
||||
║ ║ ╔═══╗ ║ ║
|
||||
║ ╔══║ ║ 0 ║ ║══╗ ║
|
||||
|
|
@ -306,7 +306,7 @@
|
|||
║ ║ ║ ║ ║ ║
|
||||
║ ╚══╝ ╚══╝ ║
|
||||
║ ║
|
||||
║ Inventory ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -322,11 +322,11 @@
|
|||
</data>
|
||||
<data name="Container.Hopper" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Priekšmetu piltuve ║
|
||||
║ ╔═══╦═══╦═══╦═══╦═══╗ ║
|
||||
║ ║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ ║
|
||||
║ ╚═══╩═══╩═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Inventārs ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║12 ║13 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
|
|||
|
|
@ -119,15 +119,15 @@
|
|||
</resheader>
|
||||
<data name="Container.BrewingStand" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Brewing Stand ║
|
||||
║ Варочная стойка ║
|
||||
║ ╔═══╗ ⡈ ⠄╔═══╗ ║
|
||||
║ ║ 4 ╟───╮ ⢠⡐⢈║ 3 ║ ┃ ║
|
||||
║ ╚═══╝ ╭─╯ ⠂⡠⢂╚╦╦╦╝ ┃ ║
|
||||
║ ╰───■■■■ ║║║ ▼ ║
|
||||
║ ╔═══╦═╝║╚═╦═══╗ ║
|
||||
║ ║ 0 ║╔═╩═╗║ 2 ║ ║
|
||||
║ ╚═══╝║ 1 ║╚═══╝ ║
|
||||
║ Inventory ╚═══╝ ║
|
||||
║ ╰───■■■■ ║║║ ▼ ║
|
||||
║ ╔═══╦═╝║╚═╦═══╗ ║
|
||||
║ ║ 0 ║╔═╩═╗║ 2 ║ ║
|
||||
║ ╚═══╝║ 1 ║╚═══╝ ║
|
||||
║ Инвентарь ╚═══╝ ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║12 ║13 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -143,7 +143,7 @@
|
|||
</data>
|
||||
<data name="Container.Crafting" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Crafting ║
|
||||
║ Крафт ║
|
||||
║ ╔═══╦═══╦═══╗ ║
|
||||
║ ║ 1 ║ 2 ║ 3 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ╔═══╗ ║
|
||||
|
|
@ -151,7 +151,7 @@
|
|||
║ ╠═══╬═══╬═══╣ ╚═══╝ ║
|
||||
║ ║ 7 ║ 8 ║ 9 ║ ║
|
||||
║ ╚═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║10 ║11 ║12 ║13 ║14 ║15 ║16 ║17 ║18 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -166,16 +166,16 @@
|
|||
╚═════════════════════════════════════╝</value>
|
||||
</data>
|
||||
<data name="Container.EnchantingTable" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Enchant ║
|
||||
<value>═════════════════════════════════════╗
|
||||
║ Зачарвать ║
|
||||
║ ╔════════════════════╗ ║
|
||||
║ ║ Top ║ ║
|
||||
║ ║ Верхний ║ ║
|
||||
║ ╔═══╦═══╗ ╠════════════════════╣ ║
|
||||
║ ║ 0 ║ 1 ║ ║ Middle ║ ║
|
||||
║ ║ 0 ║ 1 ║ ║ Средний ║ ║
|
||||
║ ╚═══╩═══╝ ╠════════════════════╣ ║
|
||||
║ ║ Bottom ║ ║
|
||||
║ ║ Нижний ║ ║
|
||||
║ ╚════════════════════╝ ║
|
||||
║ Inventory ║
|
||||
║ Инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -191,7 +191,7 @@
|
|||
</data>
|
||||
<data name="Container.Furnace" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Печка ║
|
||||
║ ╔═══╗ ║
|
||||
║ ║ 0 ║ ║
|
||||
║ ╚═══╝ ╔═══╗ ║
|
||||
|
|
@ -200,7 +200,7 @@
|
|||
║ ╔═══╗ ║
|
||||
║ ║ 1 ║ ║
|
||||
║ ╚═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -216,7 +216,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_3x3" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Контейнер ║
|
||||
║ ╔═══╦═══╦═══╗ ║
|
||||
║ ║ 0 ║ 1 ║ 2 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ║
|
||||
|
|
@ -224,7 +224,7 @@
|
|||
║ ╠═══╬═══╬═══╣ ║
|
||||
║ ║ 6 ║ 7 ║ 8 ║ ║
|
||||
║ ╚═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 9 ║10 ║11 ║12 ║13 ║14 ║15 ║16 ║17 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -240,7 +240,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_9x3" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Маленький инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -248,7 +248,7 @@
|
|||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║18 ║19 ║20 ║21 ║22 ║23 ║24 ║25 ║26 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║ Inventory ║
|
||||
║ Интвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║27 ║28 ║29 ║30 ║31 ║32 ║33 ║34 ║35 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -264,7 +264,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_9x6" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Контейнер ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -278,7 +278,7 @@
|
|||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║45 ║46 ║47 ║48 ║49 ║50 ║51 ║52 ║53 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║ Inventory ║
|
||||
║ Инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║54 ║55 ║56 ║57 ║58 ║59 ║60 ║61 ║62 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -294,7 +294,7 @@
|
|||
</data>
|
||||
<data name="Container.Grindstone" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Repair & Disenchant ║
|
||||
║ Починка & снятие чар ║
|
||||
║ ╔═════════╗ ║
|
||||
║ ║ ╔═══╗ ║ ║
|
||||
║ ╔══║ ║ 0 ║ ║══╗ ║
|
||||
|
|
@ -306,7 +306,7 @@
|
|||
║ ║ ║ ║ ║ ║
|
||||
║ ╚══╝ ╚══╝ ║
|
||||
║ ║
|
||||
║ Inventory ║
|
||||
║ Инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -322,11 +322,11 @@
|
|||
</data>
|
||||
<data name="Container.Hopper" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Воронка ║
|
||||
║ ╔═══╦═══╦═══╦═══╦═══╗ ║
|
||||
║ ║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ ║
|
||||
║ ╚═══╩═══╩═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Инвентарь ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║12 ║13 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
|
|||
|
|
@ -119,7 +119,7 @@
|
|||
</resheader>
|
||||
<data name="Container.BrewingStand" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Brewing Stand ║
|
||||
║ İksir Tezgahı ║
|
||||
║ ╔═══╗ ⡈ ⠄╔═══╗ ║
|
||||
║ ║ 4 ╟───╮ ⢠⡐⢈║ 3 ║ ┃ ║
|
||||
║ ╚═══╝ ╭─╯ ⠂⡠⢂╚╦╦╦╝ ┃ ║
|
||||
|
|
@ -127,7 +127,7 @@
|
|||
║ ╔═══╦═╝║╚═╦═══╗ ║
|
||||
║ ║ 0 ║╔═╩═╗║ 2 ║ ║
|
||||
║ ╚═══╝║ 1 ║╚═══╝ ║
|
||||
║ Inventory ╚═══╝ ║
|
||||
║ Envanter ╚═══╝ ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║12 ║13 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -143,7 +143,7 @@
|
|||
</data>
|
||||
<data name="Container.Crafting" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Crafting ║
|
||||
║ Üretim ║
|
||||
║ ╔═══╦═══╦═══╗ ║
|
||||
║ ║ 1 ║ 2 ║ 3 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ╔═══╗ ║
|
||||
|
|
@ -151,7 +151,7 @@
|
|||
║ ╠═══╬═══╬═══╣ ╚═══╝ ║
|
||||
║ ║ 7 ║ 8 ║ 9 ║ ║
|
||||
║ ╚═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║10 ║11 ║12 ║13 ║14 ║15 ║16 ║17 ║18 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -167,15 +167,15 @@
|
|||
</data>
|
||||
<data name="Container.EnchantingTable" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Enchant ║
|
||||
║ Büyü ║
|
||||
║ ╔════════════════════╗ ║
|
||||
║ ║ Top ║ ║
|
||||
║ ║ Üst ║ ║
|
||||
║ ╔═══╦═══╗ ╠════════════════════╣ ║
|
||||
║ ║ 0 ║ 1 ║ ║ Middle ║ ║
|
||||
║ ║ 0 ║ 1 ║ ║ Orta ║ ║
|
||||
║ ╚═══╩═══╝ ╠════════════════════╣ ║
|
||||
║ ║ Bottom ║ ║
|
||||
║ ║ Alt ║ ║
|
||||
║ ╚════════════════════╝ ║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -191,7 +191,7 @@
|
|||
</data>
|
||||
<data name="Container.Furnace" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Sandık ║
|
||||
║ ╔═══╗ ║
|
||||
║ ║ 0 ║ ║
|
||||
║ ╚═══╝ ╔═══╗ ║
|
||||
|
|
@ -200,7 +200,7 @@
|
|||
║ ╔═══╗ ║
|
||||
║ ║ 1 ║ ║
|
||||
║ ╚═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -216,7 +216,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_3x3" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Sandık ║
|
||||
║ ╔═══╦═══╦═══╗ ║
|
||||
║ ║ 0 ║ 1 ║ 2 ║ ║
|
||||
║ ╠═══╬═══╬═══╣ ║
|
||||
|
|
@ -224,7 +224,7 @@
|
|||
║ ╠═══╬═══╬═══╣ ║
|
||||
║ ║ 6 ║ 7 ║ 8 ║ ║
|
||||
║ ╚═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 9 ║10 ║11 ║12 ║13 ║14 ║15 ║16 ║17 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -240,7 +240,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_9x3" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Sandık ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -248,7 +248,7 @@
|
|||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║18 ║19 ║20 ║21 ║22 ║23 ║24 ║25 ║26 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║27 ║28 ║29 ║30 ║31 ║32 ║33 ║34 ║35 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -264,7 +264,7 @@
|
|||
</data>
|
||||
<data name="Container.Generic_9x6" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Sandık ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -278,7 +278,7 @@
|
|||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
║║45 ║46 ║47 ║48 ║49 ║50 ║51 ║52 ║53 ║║
|
||||
║╚═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╩═══╝║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║54 ║55 ║56 ║57 ║58 ║59 ║60 ║61 ║62 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -294,7 +294,7 @@
|
|||
</data>
|
||||
<data name="Container.Grindstone" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Repair & Disenchant ║
|
||||
║ Tamir & Büyü Kaldırma ║
|
||||
║ ╔═════════╗ ║
|
||||
║ ║ ╔═══╗ ║ ║
|
||||
║ ╔══║ ║ 0 ║ ║══╗ ║
|
||||
|
|
@ -306,7 +306,7 @@
|
|||
║ ║ ║ ║ ║ ║
|
||||
║ ╚══╝ ╚══╝ ║
|
||||
║ ║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 3 ║ 4 ║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
@ -322,11 +322,11 @@
|
|||
</data>
|
||||
<data name="Container.Hopper" xml:space="preserve">
|
||||
<value>╔═════════════════════════════════════╗
|
||||
║ Container ║
|
||||
║ Sandık ║
|
||||
║ ╔═══╦═══╦═══╦═══╦═══╗ ║
|
||||
║ ║ 0 ║ 1 ║ 2 ║ 3 ║ 4 ║ ║
|
||||
║ ╚═══╩═══╩═══╩═══╩═══╝ ║
|
||||
║ Inventory ║
|
||||
║ Envanter ║
|
||||
║╔═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╦═══╗║
|
||||
║║ 5 ║ 6 ║ 7 ║ 8 ║ 9 ║10 ║11 ║12 ║13 ║║
|
||||
║╠═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╬═══╣║
|
||||
|
|
|
|||
|
|
@ -118,25 +118,25 @@
|
|||
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
|
||||
</resheader>
|
||||
<data name="bot.alerts.end_rain" xml:space="preserve">
|
||||
<value>§cWeather change: It is no longer raining.§r</value>
|
||||
<value>§cWetteränderung: Es regnet nicht mehr.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.end_thunderstorm" xml:space="preserve">
|
||||
<value>§cWeather change: It is no longer a thunderstorm.§r</value>
|
||||
<value>§cWetteränderung: Es ist kein Gewitter mehr.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.start_rain" xml:space="preserve">
|
||||
<value>§cWeather change: It is raining now.§r</value>
|
||||
<value>§cWetteränderung: Es regnet jetzt.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.start_thunderstorm" xml:space="preserve">
|
||||
<value>§cWeather change: It is a thunderstorm.§r</value>
|
||||
<value>§cWetteränderung: Es gewittert jetzt.§r</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.invalid_walk_range" xml:space="preserve">
|
||||
<value>Invalid walk range provided, must be a positive integer greater than 0, using default value of 5!</value>
|
||||
<value>Ungültiger Laufbereich angegeben, muss eine positive ganze Zahl größer als 0 sein, mit einem Standardwert von 5!</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.not_using_terrain_handling" xml:space="preserve">
|
||||
<value>The terrain handling is not enabled in the settings of the client, enable it if you want to use it with this bot. Using alternative (command) method.</value>
|
||||
<value>Das Geländehandling ist in den Einstellungen des Clients nicht aktiviert, aktivieren Sie es, wenn Sie es mit diesem Bot verwenden möchten. Verwendung einer alternativen (Befehl) Methode.</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.swapping" xml:space="preserve">
|
||||
<value>The time range begins with a bigger value, swapped them around.</value>
|
||||
<value>Die Zeitspanne beginnt mit einem größeren Wert, die beiden Werte wurden vertauscht.</value>
|
||||
</data>
|
||||
<data name="bot.autoAttack.invalidcooldown" xml:space="preserve">
|
||||
<value>Angriffscooldown kann nicht kleiner als 0 sein. Benutze Auto als Standard.</value>
|
||||
|
|
@ -199,10 +199,10 @@
|
|||
<value>Stoppe den aktuell laufenden Crafting-Prozess</value>
|
||||
</data>
|
||||
<data name="bot.autocraft.invaild_result" xml:space="preserve">
|
||||
<value>Invalid result item!</value>
|
||||
<value>Ungültiges Ergebnis-Element!</value>
|
||||
</data>
|
||||
<data name="bot.autocraft.invaild_slots" xml:space="preserve">
|
||||
<value>The number of slots does not match and has been adjusted automatically.</value>
|
||||
<value>Die Anzahl der Plätze stimmt nicht überein und wurde automatisch angepasst.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.loaded" xml:space="preserve">
|
||||
<value>Erfolgreich geladen</value>
|
||||
|
|
@ -407,7 +407,7 @@
|
|||
<value>Warte {0:0.000} Sekunden vor erneuter Verbindung...</value>
|
||||
</data>
|
||||
<data name="bot.autoRespond.file_not_found" xml:space="preserve">
|
||||
<value>File not found: '{0}'</value>
|
||||
<value>Datei nicht gefunden: '{0}'</value>
|
||||
</data>
|
||||
<data name="bot.autoRespond.loaded_match" xml:space="preserve">
|
||||
<value>Loaded match:
|
||||
|
|
@ -2329,7 +2329,7 @@ Usage examples: "/tell <mybot> connect Server1", "/connect Server2"</value
|
|||
<value>Kann nicht zum Server verbinden : Diese Version wird nicht unterstützt !</value>
|
||||
</data>
|
||||
<data name="error.usage" xml:space="preserve">
|
||||
<value>Usage:</value>
|
||||
<value>Benutzung:</value>
|
||||
</data>
|
||||
<data name="error.version_different" xml:space="preserve">
|
||||
<value>§8Der Server meldet eine andere Version als manuell angegeben. Login könnte fehlschlagen.</value>
|
||||
|
|
|
|||
|
|
@ -2332,7 +2332,7 @@ If the connection to the Minecraft game server is blocked by the firewall, set E
|
|||
<value>Impossible de se connecter au serveur : Cette version n'est pas prise en charge !</value>
|
||||
</data>
|
||||
<data name="error.usage" xml:space="preserve">
|
||||
<value>Usage:</value>
|
||||
<value>Utilisation:</value>
|
||||
</data>
|
||||
<data name="error.version_different" xml:space="preserve">
|
||||
<value>§8Le serveur indique une version différente de celle réglée manuellement. La connexion pourrait échouer.</value>
|
||||
|
|
|
|||
|
|
@ -118,269 +118,269 @@
|
|||
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
|
||||
</resheader>
|
||||
<data name="bot.alerts.end_rain" xml:space="preserve">
|
||||
<value>§cWeather change: It is no longer raining.§r</value>
|
||||
<value>§cLaikapstākļu maiņa: Vairs nelīst.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.end_thunderstorm" xml:space="preserve">
|
||||
<value>§cWeather change: It is no longer a thunderstorm.§r</value>
|
||||
<value>§cLaikapstākļu maiņa: vairs nav pērkona negaiss.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.start_rain" xml:space="preserve">
|
||||
<value>§cWeather change: It is raining now.§r</value>
|
||||
<value>§cLaikapstākļu maiņa: Šobrīd līst lietus.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.start_thunderstorm" xml:space="preserve">
|
||||
<value>§cWeather change: It is a thunderstorm.§r</value>
|
||||
<value>§cLaikapstākļu maiņa: Tagad ir pērkona negaiss.§r</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.invalid_walk_range" xml:space="preserve">
|
||||
<value>Invalid walk range provided, must be a positive integer greater than 0, using default value of 5!</value>
|
||||
<value>Norādītais nederīgs pārvietošanās diapazons. Tam ir jābūt pozitīvam veselam skaitlim, kas ir lielāks par 0, izmantojot noklusējuma vērtību 5!</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.not_using_terrain_handling" xml:space="preserve">
|
||||
<value>The terrain handling is not enabled in the settings of the client, enable it if you want to use it with this bot. Using alternative (command) method.</value>
|
||||
<value>Apvidus apstrāde nav iespējota klienta iestatījumos, iespējojiet to, ja vēlaties to izmantot ar šo robotprogrammatūru. Izmantojot alternatīvo (komandu) metodi.</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.swapping" xml:space="preserve">
|
||||
<value>The time range begins with a bigger value, swapped them around.</value>
|
||||
<value>Laika diapazons sākas ar lielāku vērtību, apmainīju tos.</value>
|
||||
</data>
|
||||
<data name="bot.autoAttack.invalidcooldown" xml:space="preserve">
|
||||
<value>Attack cooldown value cannot be smaller than 0.</value>
|
||||
<value>Uzbrukuma biežums nedrīkst būt mazāks par 0.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.aborted" xml:space="preserve">
|
||||
<value>Crafting aborted! Check your available materials.</value>
|
||||
<value>Amatniecība pārtraukta! Pārbaudiet pieejamos materiālus.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.alias" xml:space="preserve">
|
||||
<value>Auto-crafting ChatBot command alias</value>
|
||||
<value>Automātiskās amatniecības ChatBot komandas aizstājvards</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.available_cmd" xml:space="preserve">
|
||||
<value>Available commands: {0}. Use /autocraft help <cmd name> for more information. You may use /ac as command alias.</value>
|
||||
<value>Pieejamās komandas: {0}. Izmantojiet /autocraft palīdzība </autocraft help>, lai iegūtu vairāk informācijas. Kā komandas aizstājvārdu varat izmantot /ac.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.close_inventory" xml:space="preserve">
|
||||
<value>Inventory #{0} was closed by AutoCraft</value>
|
||||
<value>AutoAmatniecība aiztaisīja inventāru #{0}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.cmd" xml:space="preserve">
|
||||
<value>Auto-crafting ChatBot command</value>
|
||||
<value>AutoAmatniecībās ChatBot komanda</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.cmd.list" xml:space="preserve">
|
||||
<value>Total {0} recipes loaded: {1}</value>
|
||||
<value>Kopā ielādētas {0} receptes: {1}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.cmd.resetcfg" xml:space="preserve">
|
||||
<value>Resetting your config to default</value>
|
||||
<value>Notiek noklusējuma konfigurācijas atiestatīšana</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.craft_fail" xml:space="preserve">
|
||||
<value>Crafting failed! Waiting for more materials</value>
|
||||
<value>Izgatavošana neizdevās! Gaida vairāk materiālu</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.debug.no_config" xml:space="preserve">
|
||||
<value>No config found. Writing a new one.</value>
|
||||
<value>Netika atrasta konfigurācija. Tiek izveidota jauna.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.error.config" xml:space="preserve">
|
||||
<value>Error while parsing config: {0}</value>
|
||||
<value>Kļūda, analizējot konfigurāciju: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.exception.duplicate" xml:space="preserve">
|
||||
<value>Duplicate recipe name specified: {0}</value>
|
||||
<value>Norādīts dublikāta receptes nosaukums: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.exception.name_miss" xml:space="preserve">
|
||||
<value>Missing recipe name while parsing a recipe</value>
|
||||
<value>Parsējot recepti, trūkst receptes nosaukuma</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.help" xml:space="preserve">
|
||||
<value>Get the command description. Usage: /autocraft help <command name></value>
|
||||
<value>Iegūstiet komandas aprakstu. Lietojums: /autocraft palīdzība <komandas nosaukums></value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.list" xml:space="preserve">
|
||||
<value>List available recipes.</value>
|
||||
<value>Norādiet pieejamās receptes.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.load" xml:space="preserve">
|
||||
<value>Load the config file.</value>
|
||||
<value>Ielādējiet konfigurācijas failu.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.reload" xml:space="preserve">
|
||||
<value>Reload the config file.</value>
|
||||
<value>Pārlādējiet konfigurācijas failu.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.resetcfg" xml:space="preserve">
|
||||
<value>Write the default example config to default location.</value>
|
||||
<value>Ierakstiet noklusējuma konfigurācijas piemēru noklusējuma vietā.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.start" xml:space="preserve">
|
||||
<value>Start the crafting. Usage: /autocraft start <recipe name></value>
|
||||
<value>Sāciet amatniecību. Lietojums: /autocraft start <receptes nosaukums></value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.stop" xml:space="preserve">
|
||||
<value>Stop the current running crafting process</value>
|
||||
<value>Apturiet pašreizējo darbināšanas procesu</value>
|
||||
</data>
|
||||
<data name="bot.autocraft.invaild_result" xml:space="preserve">
|
||||
<value>Invalid result item!</value>
|
||||
<value>Nederīgs rezultāta lieta!</value>
|
||||
</data>
|
||||
<data name="bot.autocraft.invaild_slots" xml:space="preserve">
|
||||
<value>The number of slots does not match and has been adjusted automatically.</value>
|
||||
<value>Brīvo vietu skaits neatbilst un ir pielāgots automātiski.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.loaded" xml:space="preserve">
|
||||
<value>Successfully loaded</value>
|
||||
<value>Veiksmīgi ielādēts</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.missing_material" xml:space="preserve">
|
||||
<value>Missing material: {0}</value>
|
||||
<value>Trūkst materiāla: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.no_recipe_name" xml:space="preserve">
|
||||
<value>Please specify the recipe name you want to craft.</value>
|
||||
<value>Lūdzu, norādiet receptes nosaukumu, kuru vēlaties izmantot.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.recipe_not_exist" xml:space="preserve">
|
||||
<value>Specified recipe name does not exist. Check your config file.</value>
|
||||
<value>Norādītais receptes nosaukums nepastāv. Pārbaudiet savu konfigurācijas failu.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.start" xml:space="preserve">
|
||||
<value>Starting AutoCraft: {0}</value>
|
||||
<value>AutoAmatniecība tiek palaista: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.start_fail" xml:space="preserve">
|
||||
<value>AutoCraft cannot be started. Check your available materials for crafting {0}</value>
|
||||
<value>AutoAmatniecību nevar palaist. Pārbaudiet pieejamos materiālus, lai uztaisītu {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.stop" xml:space="preserve">
|
||||
<value>AutoCraft stopped</value>
|
||||
<value>AutoAmatniecība apstājās</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.table_not_found" xml:space="preserve">
|
||||
<value>table not found</value>
|
||||
<value>darbošanās galds nav atrasts</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.timeout" xml:space="preserve">
|
||||
<value>Action timeout! Reason: {0}</value>
|
||||
<value>Darbības noildze! Iemesls: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autodig.available_cmd" xml:space="preserve">
|
||||
<value>Available commands: {0}. Use /digbot help <cmd name> for more information.</value>
|
||||
<value>Pieejamās komandas: {0}. Izmantojiet /digbot palīdzību <komandas nosaukums> lai iegūtu vairāk informācijas.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.cmd" xml:space="preserve">
|
||||
<value>Auto-digging ChatBot command</value>
|
||||
<value>AutoRakšanas ChatBot komanda</value>
|
||||
</data>
|
||||
<data name="bot.autodig.dig_timeout" xml:space="preserve">
|
||||
<value>Digging block timeout, retry.</value>
|
||||
<value>Rakšanas bloka taimauts, mēģiniet vēlreiz.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.help.help" xml:space="preserve">
|
||||
<value>Get the command description. Usage: /digbot help <command name></value>
|
||||
<value>Iegūstiet komandas aprakstu. Lietojums: /digbot palīdzība <komandas nosaukums></value>
|
||||
</data>
|
||||
<data name="bot.autodig.help.start" xml:space="preserve">
|
||||
<value>Start the automatic digging bot.</value>
|
||||
<value>Ieslēdziet automātisko rakšanas robotu.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.help.stop" xml:space="preserve">
|
||||
<value>Deactivate the automatic digging bot.</value>
|
||||
<value>Izslēdziet automātisko rakšanas robotu.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.not_allow" xml:space="preserve">
|
||||
<value>The block currently pointed to is not in the allowed list.</value>
|
||||
<value>Bloks, uz kuru pašlaik ir norādīts, nav atļauto sarakstā.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.start" xml:space="preserve">
|
||||
<value>Automatic digging has started.</value>
|
||||
<value>Ir sākusies automātiskā rakšana.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.start_delay" xml:space="preserve">
|
||||
<value>Digging will start in {0:0.0} second(s).</value>
|
||||
<value>Rakšana sāksies pēc {0:0.0} sekundes(-ēm).</value>
|
||||
</data>
|
||||
<data name="bot.autodig.stop" xml:space="preserve">
|
||||
<value>Auto-digging has been stopped.</value>
|
||||
<value>Automātiskā rakšana ir apturēta.</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.added" xml:space="preserve">
|
||||
<value>Added item {0}</value>
|
||||
<value>Pievienots vienums {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.alias" xml:space="preserve">
|
||||
<value>AutoDrop ChatBot command alias</value>
|
||||
<value>AutoIzmešanas ChatBot komandas aizstājvārds</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.cmd" xml:space="preserve">
|
||||
<value>AutoDrop ChatBot command</value>
|
||||
<value>AutoIzmešanas ChatBot komanda</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.incorrect_name" xml:space="preserve">
|
||||
<value>Incorrect item name {0}. Please try again.</value>
|
||||
<value>Nepareizs vienuma nosaukums {0}. Lūdzu mēģiniet vēlreiz.</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.list" xml:space="preserve">
|
||||
<value>Total {0} in the list:
|
||||
<value>Kopā {0} sarakstā:
|
||||
{1}</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.no_inventory" xml:space="preserve">
|
||||
<value>Cannot find inventory {0}!</value>
|
||||
<value>Nevar atrast inventāru {0}!</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.no_item" xml:space="preserve">
|
||||
<value>No item in the list</value>
|
||||
<value>Sarakstā nav neviena vienuma</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.no_mode" xml:space="preserve">
|
||||
<value>Cannot read drop mode from config. Using include mode.</value>
|
||||
<value>Nevar nolasīt nomešanas režīmu no konfigurācijas. Iekļaušanas režīma izmantošana.</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.not_in_list" xml:space="preserve">
|
||||
<value>Item not in the list</value>
|
||||
<value>Vienums nav sarakstā</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.off" xml:space="preserve">
|
||||
<value>AutoDrop disabled</value>
|
||||
<value>AutoIzmešana atspējota</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.on" xml:space="preserve">
|
||||
<value>AutoDrop enabled</value>
|
||||
<value>AutoIzmešana iespējota</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.removed" xml:space="preserve">
|
||||
<value>Removed item {0}</value>
|
||||
<value>Noņemts vienums {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.switched" xml:space="preserve">
|
||||
<value>Switched to {0} mode.</value>
|
||||
<value>Pārslēgts uz režīmu {0}.</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.unknown_mode" xml:space="preserve">
|
||||
<value>Unknwon mode. Available modes: Include, Exclude, Everything</value>
|
||||
<value>Nezināms režīms. Pieejamie režīmi: Include, Exclude, Everything</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.available_cmd" xml:space="preserve">
|
||||
<value>Available commands: {0}. Use /fish help <cmd name> for more information.</value>
|
||||
<value>Pieejamās komandas: {0}. Izmantojiet /fish help <komandas nosaukums> lai iegūtu vairāk informācijas.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.cast_timeout" xml:space="preserve">
|
||||
<value>Casting timeout and will soon retry. (Timeout increased to {0:0.0} sec).</value>
|
||||
<value>Apraides noildze, un drīzumā tiks mēģināts vēlreiz. (Taimauts palielināts līdz {0:0.0} s).</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.caught" xml:space="preserve">
|
||||
<value>Retract the fishing rod. (Count: {0})</value>
|
||||
<value>Ievelciet makšķeri. (Skaits: {0})</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.caught_at" xml:space="preserve">
|
||||
<value>Retract the fishing rod at ({0:0.0},{1:0.0},{2:0.0})! (Count: {3})</value>
|
||||
<value>Ievelciet makšķeri uz ({0:0.0},{1:0.0},{2:0.0})! (Skaits: {3})</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.cmd" xml:space="preserve">
|
||||
<value>Auto-Fishing ChatBot command</value>
|
||||
<value>AutoZvejošanas ChatBot komanda</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.despawn" xml:space="preserve">
|
||||
<value>Fish floating despawn, will re-cast.</value>
|
||||
<value>Noķertā zivs pazuda, tiks pārmests.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.fishing_timeout" xml:space="preserve">
|
||||
<value>Fishing timeout, will soon re-cast.</value>
|
||||
<value>Makšķerēšanas taimauts, drīz tiks atkārtots.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.got" xml:space="preserve">
|
||||
<value>Fishing got {0}</value>
|
||||
<value>Makšķerēšana ieguva {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.help" xml:space="preserve">
|
||||
<value>Get the command description. Usage: /fish help <command name></value>
|
||||
<value>Iegūstiet komandas aprakstu. Lietojums: /fish help <komandas nosaukums></value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.start" xml:space="preserve">
|
||||
<value>Start auto-fishing.</value>
|
||||
<value>Sāciet automātisko makšķerēšanu.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.status" xml:space="preserve">
|
||||
<value>List all obtained items. Or use "/fish status clear" to clear the list.</value>
|
||||
<value>Uzskaitiet visus iegūtos vienumus. Vai arī izmantojiet "/fish status clear", lai notīrītu sarakstu.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.stop" xml:space="preserve">
|
||||
<value>Stop auto-fishing.</value>
|
||||
<value>Apstādiniet AutoMaksķerēšanu.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.no_inv_handle" xml:space="preserve">
|
||||
<value>Inventory handling is not enabled. Cannot check rod durability and switch rods.</value>
|
||||
<value>Inventāra apstrāde nav iespējota. Nevar pārbaudīt makšķeres izturību un pārslēgt makšķeres.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.no_rod" xml:space="preserve">
|
||||
<value>Current fishing rod is not available. Maybe broken or low durability?</value>
|
||||
<value>Pašreizējā makšķere nav pieejama. Varbūt salūzis vai zema izturība?</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.start" xml:space="preserve">
|
||||
<value>Start auto-fishing.</value>
|
||||
<value>Sāciet automātisko makšķerēšanu.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.start_at" xml:space="preserve">
|
||||
<value>Fishing will start in {0:0.0} second(s).</value>
|
||||
<value>Makšķerēšana sāksies pēc {0:0.0} sekundes(-ēm).</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.status_clear" xml:space="preserve">
|
||||
<value>The record of the obtained items has been cleared.</value>
|
||||
<value>Iegūto priekšmetu uzskaite ir notīrīta.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.status_info" xml:space="preserve">
|
||||
<value>All items obtained from fishing (not entirely accurate):</value>
|
||||
<value>Visas preces, kas iegūtas no makšķerēšanas (nav pilnīgi precīzi):</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.stop" xml:space="preserve">
|
||||
<value>Stop auto-fishing.</value>
|
||||
<value>Apstādiniet AutoMakšķerēšanu.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.switch" xml:space="preserve">
|
||||
<value>Switch to the rod in slot {0}, durability {1}/64.</value>
|
||||
<value>Pārslēdzieties uz makšķeri slotā {0}, izturība {1}/64.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.throw" xml:space="preserve">
|
||||
<value>Casting successfully.</value>
|
||||
<value>Metiens veiksmīgs.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.update_lookat" xml:space="preserve">
|
||||
<value>Update yaw = {0:0.00}, pitch = {1:0.00}.</value>
|
||||
<value>Atjaunināts slīpums = {0:0.00}, augstums = {1:0.00}.</value>
|
||||
</data>
|
||||
<data name="bot.autoRelog.curr_dir" xml:space="preserve">
|
||||
<value>Current directory was: {0}</value>
|
||||
<value>Pašreizējais direktorijs bija: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoRelog.disconnect_msg" xml:space="preserve">
|
||||
<value>Got disconnected with message: {0}</value>
|
||||
<value>Atslēdzās ar ziņojumu: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoRelog.ignore_user_logout" xml:space="preserve">
|
||||
<value>Disconnection initiated by User or MCC bot. Ignoring.</value>
|
||||
<value>Atvienošanos ierosinājis lietotājs vai MCC bots. Ignorē.</value>
|
||||
</data>
|
||||
<data name="bot.autoRelog.launch" xml:space="preserve">
|
||||
<value>Launching with {0} reconnection attempts</value>
|
||||
<value>Tiek palaists ar {0} atkārtota savienojuma mēģinājumiem</value>
|
||||
</data>
|
||||
<data name="bot.autoRelog.loaded" xml:space="preserve">
|
||||
<value>Loaded message: {0}</value>
|
||||
|
|
@ -458,7 +458,7 @@ cooldown: {6}</value>
|
|||
<value>Direction of the Discord Brdige has been switched to '{0}'!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.direction.both" xml:space="preserve">
|
||||
<value>Both</value>
|
||||
<value>Abi</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.direction.discord" xml:space="preserve">
|
||||
<value>Discord</value>
|
||||
|
|
@ -467,120 +467,120 @@ cooldown: {6}</value>
|
|||
<value>Minecraft</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.guild_not_found" xml:space="preserve">
|
||||
<value>The provided guild/server with an id '{0}' has not been found!</value>
|
||||
<value>Norādītā ģilde/serveris ar id '{0}' nav atrasts!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.invalid_direction" xml:space="preserve">
|
||||
<value>Invalid direction provided! Available directions: both|b, minecraft|mc, discord|dsc. Example: "dscbridge direction mc"</value>
|
||||
<value>Norādīts nederīgs virziens! Pieejamās norādes: both|b, minecraft|mc, discord|dsc. Piemērs: "dscbridge direction mc"</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.missing_token" xml:space="preserve">
|
||||
<value>Please provide a valid token!</value>
|
||||
<value>Lūdzu, norādiet derīgu žetonu!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.unknown_error" xml:space="preserve">
|
||||
<value>An unknown error has occured!</value>
|
||||
<value>Radās nezināma kļūda!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.already_running" xml:space="preserve">
|
||||
<value>The bot is already farming!</value>
|
||||
<value>Bots jau saimnieko!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.already_stopped" xml:space="preserve">
|
||||
<value>The bot has already stopped farming!</value>
|
||||
<value>Bots jau ir pārtraucis lauksaimniecību!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.crop_type" xml:space="preserve">
|
||||
<value>Crop type</value>
|
||||
<value>Kultūrauga veids</value>
|
||||
</data>
|
||||
<data name="bot.farmer.desc" xml:space="preserve">
|
||||
<value>Farming bot</value>
|
||||
<value>Lauksaimniecības bots</value>
|
||||
</data>
|
||||
<data name="bot.farmer.invalid_crop_type" xml:space="preserve">
|
||||
<value>Invalid crop type provided (Types which you can use: Beetroot, Carrot, Melon, Netherwart, Pumpkin, Potato, Wheat)!</value>
|
||||
<value>Norādīts nederīgs ražas veids (veidi, kurus varat izmantot: Beetroot, Carrot, Melon, Netherwart, Pumpkin, Potato, Wheat)!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.invalid_radius" xml:space="preserve">
|
||||
<value>Invalid radius provided, you must provide a valid integer number greater than 0!</value>
|
||||
<value>Norādīts nederīgs rādiuss, jums ir jānorāda derīgs vesels skaitlis, kas ir lielāks par 0!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.needs_inventory" xml:space="preserve">
|
||||
<value>The Farmer bot needs Inventory Handling in order to work, please enable it!</value>
|
||||
<value>Lai lauksaimniecības bots darbotos, ir nepieciešama inventāra apstrāde. Lūdzu, iespējojiet to!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.needs_terrain" xml:space="preserve">
|
||||
<value>The Farmer bot needs Terrain Handling in order to work, please enable it!</value>
|
||||
<value>Lai lauksaimniecības bots strādātu, ir nepieciešama reljefa apstrāde. Lūdzu, iespējojiet to!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.not_implemented" xml:space="preserve">
|
||||
<value>Not implemented bellow 1.13!</value>
|
||||
<value>Nav iespējots zemāk par 1.13!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.radius" xml:space="preserve">
|
||||
<value>Radius</value>
|
||||
<value>Radiuss</value>
|
||||
</data>
|
||||
<data name="bot.farmer.started" xml:space="preserve">
|
||||
<value>Started farming!</value>
|
||||
<value>Sācis saimniekot!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.stopped" xml:space="preserve">
|
||||
<value>Stopped farming!</value>
|
||||
<value>Beidza saimniekot!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.stopping" xml:space="preserve">
|
||||
<value>Stoping farming, this might take a second...</value>
|
||||
<value>Pārtrauc lauksaimniecību, tas var aizņemt kādu sekundi...</value>
|
||||
</data>
|
||||
<data name="bot.farmer.warining_allow_teleport" xml:space="preserve">
|
||||
<value>You have enabled teleporting, this might get your bot account kicked and in the worst case scenario banned! Use with caution!</value>
|
||||
<value>Jūs esat iespējojis teleportēšanos, tādēļ jūsu robota profils var tikt izmests un sliktākajā gadījumā tikt izbanots! Lietojiet piesardzīgi!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.warining_force_unsafe" xml:space="preserve">
|
||||
<value>You have enabled un-safe movement, the bot might get hurt!</value>
|
||||
<value>Jūs esat iespējojis nedrošu kustību, bots var tikt ievainots!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.warining_invalid_parameter" xml:space="preserve">
|
||||
<value>Invalid parameter "{0}" provided (Use format: "key:value")!</value>
|
||||
<value>Norādīts nederīgs parametrs "{0}" (izmantojiet formātu: "key:value")!</value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd" xml:space="preserve">
|
||||
<value>mailer command</value>
|
||||
<value>pasta komanda</value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd.getignored" xml:space="preserve">
|
||||
<value>--- Ignore list ---
|
||||
<value>--- Ignorēto saraksts ---
|
||||
{0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd.getmails" xml:space="preserve">
|
||||
<value>--- Mails in database ---
|
||||
<value>--- Pasta sūtījumi datubāzē ---
|
||||
{0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd.help" xml:space="preserve">
|
||||
<value>See usage</value>
|
||||
<value>Skatiet lietojumu</value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd.ignore.added" xml:space="preserve">
|
||||
<value>Added {0} to the ignore list!</value>
|
||||
<value>Pievienots {0} ignorēšanas sarakstam!</value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd.ignore.invalid" xml:space="preserve">
|
||||
<value>Missing or invalid name. Usage: {0} <username></value>
|
||||
<value>Neesošs vai nederīgs nosaukums. Lietojums: {0} <lietotājvārds></value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd.ignore.removed" xml:space="preserve">
|
||||
<value>Removed {0} from the ignore list!</value>
|
||||
<value>{0} noņemts no ignorēto cilvēku saraksta!</value>
|
||||
</data>
|
||||
<data name="bot.mailer.create.db" xml:space="preserve">
|
||||
<value>Creating new database file: {0}</value>
|
||||
<value>Jauna datu bāzes faila izveide: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.create.ignore" xml:space="preserve">
|
||||
<value>Creating new ignore list: {0}</value>
|
||||
<value>Jauna ignorēšanas saraksta izveide: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.delivered" xml:space="preserve">
|
||||
<value>Delivered: {0}</value>
|
||||
<value>Piegādāts: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init" xml:space="preserve">
|
||||
<value>Initializing Mailer with settings:</value>
|
||||
<value>Pasūtītāja inicializācija ar iestatījumiem:</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init.db" xml:space="preserve">
|
||||
<value> - Database File: {0}</value>
|
||||
<value> - Datu bāzes fails: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init.db_size" xml:space="preserve">
|
||||
<value> - Max Database Size: {0}</value>
|
||||
<value> - Maksimālais datu bāzes lielums: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init.ignore" xml:space="preserve">
|
||||
<value> - Ignore List: {0}</value>
|
||||
<value> - Ignorēto saraksts: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init.mail_retention" xml:space="preserve">
|
||||
<value> - Mail Retention: {0}</value>
|
||||
<value> - Pasta saglabāšana: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init.max_mails" xml:space="preserve">
|
||||
<value> - Max Mails per Player: {0}</value>
|
||||
<value> - Maksimālais vēstuļu skaits vienam spēlētājam: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init.public" xml:space="preserve">
|
||||
<value> - Public Interactions: {0}</value>
|
||||
<value> - Publiskā mijiedarbība: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init_fail.db_size" xml:space="preserve">
|
||||
<value>Cannot enable Mailer: Max Database Size must be greater than zero. Please review the settings.</value>
|
||||
<value>Nevar iespējot pasta ziņojumus: maksimālajam datu bāzes izmēram ir jābūt lielākam par nulli. Lūdzu, pārskatiet iestatījumus.</value>
|
||||
</data>
|
||||
<data name="bot.mailer.init_fail.mail_retention" xml:space="preserve">
|
||||
<value>Cannot enable Mailer: Mail Retention must be greater than zero. Please review the settings.</value>
|
||||
|
|
@ -712,7 +712,7 @@ cooldown: {6}</value>
|
|||
<value>Direction of the Telegram Brdige has been switched to '{0}'!</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.direction.both" xml:space="preserve">
|
||||
<value>Both</value>
|
||||
<value>Abi</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.direction.minecraft" xml:space="preserve">
|
||||
<value>Minecraft</value>
|
||||
|
|
@ -741,7 +741,7 @@ cooldown: {6}</value>
|
|||
Add the ID of this chat to "Authorized_Chat_Ids" field in the configuration file to gain access!**</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.unknown_error" xml:space="preserve">
|
||||
<value>An unknown error has occured!</value>
|
||||
<value>Radās nezināma kļūda!</value>
|
||||
</data>
|
||||
<data name="bot.testBot.said" xml:space="preserve">
|
||||
<value>Bot: {0} said : {1}</value>
|
||||
|
|
|
|||
|
|
@ -2260,7 +2260,7 @@ If the connection to the Minecraft game server is blocked by the firewall, set E
|
|||
<value>An error occured when attempting to join this server.</value>
|
||||
</data>
|
||||
<data name="error.login" xml:space="preserve">
|
||||
<value>Login failed : </value>
|
||||
<value>Inloggen mislukt : </value>
|
||||
</data>
|
||||
<data name="error.login.blocked" xml:space="preserve">
|
||||
<value>Incorrect username/password, blacklisted IP or too many logins.</value>
|
||||
|
|
|
|||
|
|
@ -124,19 +124,19 @@
|
|||
<value>§cИзменение погоды: Гроза больше не идет.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.start_rain" xml:space="preserve">
|
||||
<value>§cWeather change: It is raining now.§r</value>
|
||||
<value>§cИзменения погоды: Начался дождь.§r</value>
|
||||
</data>
|
||||
<data name="bot.alerts.start_thunderstorm" xml:space="preserve">
|
||||
<value>§cWeather change: It is a thunderstorm.§r</value>
|
||||
<value>§cИзменения погоды: Началась гроза.§r</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.invalid_walk_range" xml:space="preserve">
|
||||
<value>Invalid walk range provided, must be a positive integer greater than 0, using default value of 5!</value>
|
||||
<value>Указанный недопустимый диапазон обхода должен быть положительным целым числом, большим 0, используя значение по умолчанию 5!</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.not_using_terrain_handling" xml:space="preserve">
|
||||
<value>The terrain handling is not enabled in the settings of the client, enable it if you want to use it with this bot. Using alternative (command) method.</value>
|
||||
<value>Обработка рельефа местности не включена в настройках клиента, включите ее, если вы хотите использовать ее с этим ботом. Используя альтернативный (командный) метод.</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.swapping" xml:space="preserve">
|
||||
<value>The time range begins with a bigger value, swapped them around.</value>
|
||||
<value>Временной диапазон начинается с большего значения, поменяй их местами.</value>
|
||||
</data>
|
||||
<data name="bot.autoAttack.invalidcooldown" xml:space="preserve">
|
||||
<value>Значение кулдауна атаки не может быть меньше 0. По умолчанию используется auto.</value>
|
||||
|
|
@ -199,10 +199,10 @@
|
|||
<value>Остановить текущий запущенный процесс крафтинга</value>
|
||||
</data>
|
||||
<data name="bot.autocraft.invaild_result" xml:space="preserve">
|
||||
<value>Invalid result item!</value>
|
||||
<value>Некорректный результат предмета!.</value>
|
||||
</data>
|
||||
<data name="bot.autocraft.invaild_slots" xml:space="preserve">
|
||||
<value>The number of slots does not match and has been adjusted automatically.</value>
|
||||
<value>Количество слотов не совпадает и было скорректировано автоматически.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.loaded" xml:space="preserve">
|
||||
<value>Успешно загружен</value>
|
||||
|
|
@ -232,34 +232,34 @@
|
|||
<value>Время выполнения действия истекло! Причина: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autodig.available_cmd" xml:space="preserve">
|
||||
<value>Available commands: {0}. Use /digbot help <cmd name> for more information.</value>
|
||||
<value>Доступные команды: {0}. Используйте /digbot help <cmd name> для получения дополнительной информации.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.cmd" xml:space="preserve">
|
||||
<value>Auto-digging ChatBot command</value>
|
||||
<value>Чатбот авто-копание команды</value>
|
||||
</data>
|
||||
<data name="bot.autodig.dig_timeout" xml:space="preserve">
|
||||
<value>Digging block timeout, retry.</value>
|
||||
<value>Тайм-аут блока копания, повторите попытку.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.help.help" xml:space="preserve">
|
||||
<value>Get the command description. Usage: /digbot help <command name></value>
|
||||
<value>Получить описание команды. Использование: /autocraft help <имя команды>.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.help.start" xml:space="preserve">
|
||||
<value>Start the automatic digging bot.</value>
|
||||
<value>Запустить автоматического копаниющего бота.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.help.stop" xml:space="preserve">
|
||||
<value>Deactivate the automatic digging bot.</value>
|
||||
<value>Отключить автоматического копающего бота.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.not_allow" xml:space="preserve">
|
||||
<value>The block currently pointed to is not in the allowed list.</value>
|
||||
<value>Блок не находится в разрешенном списке.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.start" xml:space="preserve">
|
||||
<value>Automatic digging has started.</value>
|
||||
<value>Автоматическое копание началось.</value>
|
||||
</data>
|
||||
<data name="bot.autodig.start_delay" xml:space="preserve">
|
||||
<value>Digging will start in {0:0.0} second(s).</value>
|
||||
<value>Копание начнется через {0:0.0} секунд(ы).</value>
|
||||
</data>
|
||||
<data name="bot.autodig.stop" xml:space="preserve">
|
||||
<value>Auto-digging has been stopped.</value>
|
||||
<value>Автоматическое копание остановлено.</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.added" xml:space="preserve">
|
||||
<value>Добавлен элемент {0}</value>
|
||||
|
|
@ -305,70 +305,70 @@
|
|||
<value>Неизвестный режим. Доступные режимы: Включить, Исключить, Все</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.available_cmd" xml:space="preserve">
|
||||
<value>Available commands: {0}. Use /fish help <cmd name> for more information.</value>
|
||||
<value>Доступные команды: {0}. Используйте /fish help <cmd name> для получения дополнительной информации.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.cast_timeout" xml:space="preserve">
|
||||
<value>Casting timeout and will soon retry. (Timeout increased to {0:0.0} sec).</value>
|
||||
<value>Тайм-аут раздачи и скоро повторится. (Тайм-аут увеличился до {0:0.0} сек).</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.caught" xml:space="preserve">
|
||||
<value>Поймал рыбу!</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.caught_at" xml:space="preserve">
|
||||
<value>Retract the fishing rod at ({0:0.0},{1:0.0},{2:0.0})! (Count: {3})</value>
|
||||
<value>Снять удочку с рыбалки ({0:0.0},{1:0.0},{2:0.0})! (Количество - {3})</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.cmd" xml:space="preserve">
|
||||
<value>Auto-Fishing ChatBot command</value>
|
||||
<value>Команды авторыбалки ChatBot</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.despawn" xml:space="preserve">
|
||||
<value>Fish floating despawn, will re-cast.</value>
|
||||
<value>Поплавок пропал, пробуем заново.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.fishing_timeout" xml:space="preserve">
|
||||
<value>Fishing timeout, will soon re-cast.</value>
|
||||
<value>Тайм-аут рыбалки, скоро начнется повторно.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.got" xml:space="preserve">
|
||||
<value>Fishing got {0}</value>
|
||||
<value>Рыбалка получила {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.help" xml:space="preserve">
|
||||
<value>Get the command description. Usage: /fish help <command name></value>
|
||||
<value>Получить описание команды. Использование: /fish help <command name></value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.start" xml:space="preserve">
|
||||
<value>Start auto-fishing.</value>
|
||||
<value>Начать автоматическую рыбалку.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.status" xml:space="preserve">
|
||||
<value>List all obtained items. Or use "/fish status clear" to clear the list.</value>
|
||||
<value>Список всех полученных элементов. Или используйте "/fish status clear" чтобы очистить список.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.help.stop" xml:space="preserve">
|
||||
<value>Stop auto-fishing.</value>
|
||||
<value>Остановить автоматическую рыбалку.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.no_inv_handle" xml:space="preserve">
|
||||
<value>Inventory handling is not enabled. Cannot check rod durability and switch rods.</value>
|
||||
<value>Обработка инвентаря не включена. Не удается проверить прочность удочки и переключить удочку.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.no_rod" xml:space="preserve">
|
||||
<value>Нет удочки под рукой. Может быть сломана?</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.start" xml:space="preserve">
|
||||
<value>Start auto-fishing.</value>
|
||||
<value>Начать автоматическую рыбалку.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.start_at" xml:space="preserve">
|
||||
<value>Fishing will start in {0:0.0} second(s).</value>
|
||||
<value>Рыбалка начнется через {0:0.0} секунд(ы).</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.status_clear" xml:space="preserve">
|
||||
<value>The record of the obtained items has been cleared.</value>
|
||||
<value>Запись о полученных элементах была очищена.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.status_info" xml:space="preserve">
|
||||
<value>All items obtained from fishing (not entirely accurate):</value>
|
||||
<value>Все предметы, полученные от рыбалки (не совсем точно):</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.stop" xml:space="preserve">
|
||||
<value>Stop auto-fishing.</value>
|
||||
<value>Остановить автоматическую рыбалку.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.switch" xml:space="preserve">
|
||||
<value>Switch to the rod in slot {0}, durability {1}/64.</value>
|
||||
<value>Переключиться на удочку в ячейке {0}, прочность {1}/64.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.throw" xml:space="preserve">
|
||||
<value>Закинул удочку</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.update_lookat" xml:space="preserve">
|
||||
<value>Update yaw = {0:0.00}, pitch = {1:0.00}.</value>
|
||||
<value>Обновить yaw = {0:0.00}, высота = {1:0.00}.</value>
|
||||
</data>
|
||||
<data name="bot.autoRelog.curr_dir" xml:space="preserve">
|
||||
<value>Текущий каталог был: {0}</value>
|
||||
|
|
@ -440,91 +440,91 @@ cooldown: {6}</value>
|
|||
<value>Путь '{0}' содержит недопустимые символы.</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.canceled_sending" xml:space="preserve">
|
||||
<value>Sending message to Discord was canceled due an error occuring. For more info enable Debug.</value>
|
||||
<value>Отправка сообщения в Discord была отменена из-за ошибки. Для получения дополнительной информации включите Отладку.</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.channel_not_found" xml:space="preserve">
|
||||
<value>The provided channel with an id '{0}' has not been found!</value>
|
||||
<value>Канал с айди '{0}' не найден!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.command_executed" xml:space="preserve">
|
||||
<value>The command was executed with the result</value>
|
||||
<value>Команда выполнена с результатом</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.connected" xml:space="preserve">
|
||||
<value>Succesfully connected with MCC!</value>
|
||||
<value>Успешно подключено к MCC!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.desc" xml:space="preserve">
|
||||
<value>This command allows you to specify in the which direction the messages will be relayed via the Discord Bridge chat bot.</value>
|
||||
<value>Эта команда позволяет указать в каком направлении сообщения будут передаваться через бот дискорд бота.</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.direction" xml:space="preserve">
|
||||
<value>Direction of the Discord Brdige has been switched to '{0}'!</value>
|
||||
<value>Направление Discord Brdige было переключено на '{0}'!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.direction.both" xml:space="preserve">
|
||||
<value>Both</value>
|
||||
<value>Оба</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.direction.discord" xml:space="preserve">
|
||||
<value>Discord</value>
|
||||
<value>Дискорд</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.direction.minecraft" xml:space="preserve">
|
||||
<value>Minecraft</value>
|
||||
<value>Майнкрафт</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.guild_not_found" xml:space="preserve">
|
||||
<value>The provided guild/server with an id '{0}' has not been found!</value>
|
||||
<value>Гильдия/сервер с идентификатором '{0}' не найден!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.invalid_direction" xml:space="preserve">
|
||||
<value>Invalid direction provided! Available directions: both|b, minecraft|mc, discord|dsc. Example: "dscbridge direction mc"</value>
|
||||
<value>Недопустимое направление! Доступные направления: как для |b, minecraft|mc, discord|dsc. Пример: "dscbridge direction mc"</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.missing_token" xml:space="preserve">
|
||||
<value>Please provide a valid token!</value>
|
||||
<value>Пожалуйста, укажите корректный дискорд токен!</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.unknown_error" xml:space="preserve">
|
||||
<value>An unknown error has occured!</value>
|
||||
<value>Произошла неизвестная ошибка!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.already_running" xml:space="preserve">
|
||||
<value>The bot is already farming!</value>
|
||||
<value>Этот бот уже фармит!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.already_stopped" xml:space="preserve">
|
||||
<value>The bot has already stopped farming!</value>
|
||||
<value>Бот уже прекратил фарминг!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.crop_type" xml:space="preserve">
|
||||
<value>Crop type</value>
|
||||
<value>Тип культуры</value>
|
||||
</data>
|
||||
<data name="bot.farmer.desc" xml:space="preserve">
|
||||
<value>Farming bot</value>
|
||||
<value>Фарминг бот</value>
|
||||
</data>
|
||||
<data name="bot.farmer.invalid_crop_type" xml:space="preserve">
|
||||
<value>Invalid crop type provided (Types which you can use: Beetroot, Carrot, Melon, Netherwart, Pumpkin, Potato, Wheat)!</value>
|
||||
<value>Предоставлен недопустимый тип посадки (Типы, которые вы можете использовать: Свекла, Морковь, арбуз, Адский нарост, Картофель, Пшеница)!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.invalid_radius" xml:space="preserve">
|
||||
<value>Invalid radius provided, you must provide a valid integer number greater than 0!</value>
|
||||
<value>Указан неверный радиус, вы должны указать допустимое целое число больше 0!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.needs_inventory" xml:space="preserve">
|
||||
<value>The Farmer bot needs Inventory Handling in order to work, please enable it!</value>
|
||||
<value>Боту фермера нужна обработка инвентаря для работы, пожалуйста, включите его!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.needs_terrain" xml:space="preserve">
|
||||
<value>The Farmer bot needs Terrain Handling in order to work, please enable it!</value>
|
||||
<value>Для работы фермерскому боту нужна обработка местности, пожалуйста, включите её!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.not_implemented" xml:space="preserve">
|
||||
<value>Not implemented bellow 1.13!</value>
|
||||
<value>Не реализовано ниже 1.13!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.radius" xml:space="preserve">
|
||||
<value>Radius</value>
|
||||
<value>Радиус</value>
|
||||
</data>
|
||||
<data name="bot.farmer.started" xml:space="preserve">
|
||||
<value>Started farming!</value>
|
||||
<value>Фарминг запущен!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.stopped" xml:space="preserve">
|
||||
<value>Stopped farming!</value>
|
||||
<value>Фарминг остановлен!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.stopping" xml:space="preserve">
|
||||
<value>Stoping farming, this might take a second...</value>
|
||||
<value>Остановка фарминга, это может занять секунду...</value>
|
||||
</data>
|
||||
<data name="bot.farmer.warining_allow_teleport" xml:space="preserve">
|
||||
<value>You have enabled teleporting, this might get your bot account kicked and in the worst case scenario banned! Use with caution!</value>
|
||||
<value>Вы включили телепортацию, это может привести к тому, что ваш бот кикнут, а в худшем случае сценарий запрещён! С осторожностью!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.warining_force_unsafe" xml:space="preserve">
|
||||
<value>You have enabled un-safe movement, the bot might get hurt!</value>
|
||||
<value>Вы включили небезопасное движение, бот может навредить!</value>
|
||||
</data>
|
||||
<data name="bot.farmer.warining_invalid_parameter" xml:space="preserve">
|
||||
<value>Invalid parameter "{0}" provided (Use format: "key:value")!</value>
|
||||
<value>Предоставлен недопустимый параметр "{0}" (формат использования: "key:value")!</value>
|
||||
</data>
|
||||
<data name="bot.mailer.cmd" xml:space="preserve">
|
||||
<value>команда почтового клиента</value>
|
||||
|
|
@ -604,43 +604,43 @@ cooldown: {6}</value>
|
|||
<value>{0} игнорируется!</value>
|
||||
</data>
|
||||
<data name="bot.map.cmd.desc" xml:space="preserve">
|
||||
<value>Render maps (item maps)</value>
|
||||
<value>Отобразить карты (предметы карт)</value>
|
||||
</data>
|
||||
<data name="bot.map.cmd.invalid_id" xml:space="preserve">
|
||||
<value>Invalid ID provided, must be a number!</value>
|
||||
<value>Указан неверный ID, должен быть число!</value>
|
||||
</data>
|
||||
<data name="bot.map.cmd.not_found" xml:space="preserve">
|
||||
<value>A map with id '{0}' does not exists!</value>
|
||||
<value>Карта с id '{0}' не существует!</value>
|
||||
</data>
|
||||
<data name="bot.map.failed_to_render" xml:space="preserve">
|
||||
<value>Failed to render the map with id: '{0}'</value>
|
||||
<value>Не удалось отобразить карту с идентификатором: '{0}'</value>
|
||||
</data>
|
||||
<data name="bot.map.list_item" xml:space="preserve">
|
||||
<value>- Map id: {0} (Last Updated: {1})</value>
|
||||
<value>- Id карты: {0} (Последнее обновление: {1})</value>
|
||||
</data>
|
||||
<data name="bot.map.no_maps" xml:space="preserve">
|
||||
<value>No maps received!</value>
|
||||
<value>Карты не получены!</value>
|
||||
</data>
|
||||
<data name="bot.map.received" xml:space="preserve">
|
||||
<value>The list of received maps from the server:</value>
|
||||
<value>Список полученных карт с сервера:</value>
|
||||
</data>
|
||||
<data name="bot.map.received_map" xml:space="preserve">
|
||||
<value>Received a new Map, with Id: {0}</value>
|
||||
<value>Получена новая карта, с Id: {0}</value>
|
||||
</data>
|
||||
<data name="bot.map.rendered" xml:space="preserve">
|
||||
<value>Succesfully rendered a map with id '{0}' to: '{1}'</value>
|
||||
<value>Карта с идентификатором '{0}' ' успешно отобрана: '{1}'</value>
|
||||
</data>
|
||||
<data name="bot.map.resized_rendered_image" xml:space="preserve">
|
||||
<value>Resized the rendered image of the map with id: '{0}' to {1}x{1}.</value>
|
||||
<value>Изменено отображенное изображение карты с идентификатором: '{0}' до {1}x{1}.</value>
|
||||
</data>
|
||||
<data name="bot.map.scale" xml:space="preserve">
|
||||
<value>The size of the map is reduced from ({0}x{1}) to ({2}x{3}) due to the size limitation of the current terminal.</value>
|
||||
<value>Размер карты снижается с ({0}x{1}) до ({2}x{3}) из-за ограничения размера текущего терминала.</value>
|
||||
</data>
|
||||
<data name="bot.map.sent_to_discord" xml:space="preserve">
|
||||
<value>Sent a rendered image of a map with an id '{0}' to the Discord via Discord Brdige chat bot!</value>
|
||||
<value>Отправлено изображение карты с идентификатором '{0}' ' ' в Discord через чат-бот дискорд бота!</value>
|
||||
</data>
|
||||
<data name="bot.map.sent_to_telegram" xml:space="preserve">
|
||||
<value>Sent a rendered image of a map with an id '{0}' to the Telegram via Telegram Bridge chat bot!</value>
|
||||
<value>Отправлено изображение карты с идентификатором '{0}' в Телеграм через чат-бот Телеграм бот!</value>
|
||||
</data>
|
||||
<data name="bot.replayCapture.cmd" xml:space="preserve">
|
||||
<value>команда воспроизведения</value>
|
||||
|
|
@ -697,51 +697,51 @@ cooldown: {6}</value>
|
|||
действие: {6}</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.canceled_sending" xml:space="preserve">
|
||||
<value>Sending message to Telegram was canceled due an error occuring. For more info enable Debug.</value>
|
||||
<value>Отправка сообщения в Телеграм была отменена из-за ошибки. Для получения дополнительной информации включите Отладку.</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.command_executed" xml:space="preserve">
|
||||
<value>The command was executed with the result</value>
|
||||
<value>Команда выполнена с результатом</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.connected" xml:space="preserve">
|
||||
<value>Succesfully connected with the MCC!</value>
|
||||
<value>Успешно подключено к MCC!</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.desc" xml:space="preserve">
|
||||
<value>This command allows you to specify in the which direction the messages will be relayed via the Telegram Bridge chat bot.</value>
|
||||
<value>Эта команда позволяет указать в каком направлении сообщения будут передаваться через чат-бот Телеграм бота.</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.direction" xml:space="preserve">
|
||||
<value>Direction of the Telegram Brdige has been switched to '{0}'!</value>
|
||||
<value>Направление Телеграм бота было переключено на '{0}'!</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.direction.both" xml:space="preserve">
|
||||
<value>Both</value>
|
||||
<value>Оба</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.direction.minecraft" xml:space="preserve">
|
||||
<value>Minecraft</value>
|
||||
<value>Майнкрафт</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.direction.Telegram" xml:space="preserve">
|
||||
<value>Telegram</value>
|
||||
<value>Телеграм</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.disconnected" xml:space="preserve">
|
||||
<value>Disconnected from from the MCC!</value>
|
||||
<value>Отключено от MCC!</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.invalid_direction" xml:space="preserve">
|
||||
<value>Invalid direction provided! Available directions: both|b, minecraft|mc, telegram|tg|t. Example: "tgbridge direction mc"</value>
|
||||
<value>Недопустимое направление! Доступные направления: как |b, minecraft|mc, telegram|tg|t. Пример: "tgbridge direction mc"</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.missing_authorized_channels" xml:space="preserve">
|
||||
<value>[WARNING] You have not provided any Channel IDs, for "Authorized_Chat_Ids" field, anyone who finds your bot will be able to send messages and commands to it!</value>
|
||||
<value>[WARNING] Вы не указали ни одного ID канала, для поля "Authorized_Chat_Ids" любой, кто найдет вашего бота, сможет отправлять ему сообщения и команды!</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.missing_channel_id" xml:space="preserve">
|
||||
<value>[WARNING] You have not provided a Channel ID, you will ONLY get replies to commands sent from Telegram!</value>
|
||||
<value>[WARNING] Вы не предоставили ID канала, вы будете получать ответы на команды, отправленные через Телеграм!</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.missing_token" xml:space="preserve">
|
||||
<value>Please provide a valid bot token!</value>
|
||||
<value>Пожалуйста, укажите корректный телеграм бот токен!</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.unauthorized" xml:space="preserve">
|
||||
<value>**🛑 Unauthorized access! 🛑
|
||||
<value>**🛑 Неавторизованный доступ! 🛑
|
||||
|
||||
Add the ID of this chat to "Authorized_Chat_Ids" field in the configuration file to gain access!**</value>
|
||||
Добавьте ID этого чата в поле "Authorized_Chat_Ids" в файле конфигурации, чтобы получить доступ!**</value>
|
||||
</data>
|
||||
<data name="bot.TelegramBridge.unknown_error" xml:space="preserve">
|
||||
<value>An unknown error has occured!</value>
|
||||
<value>Произошла неизвестная ошибка!</value>
|
||||
</data>
|
||||
<data name="bot.testBot.said" xml:space="preserve">
|
||||
<value>Бот: {0} сказал: {1}</value>
|
||||
|
|
@ -750,16 +750,16 @@ Add the ID of this chat to "Authorized_Chat_Ids" field in the configuration file
|
|||
<value>Bot: {0} сказал мне : {1}</value>
|
||||
</data>
|
||||
<data name="botname.Alerts" xml:space="preserve">
|
||||
<value>Alerts</value>
|
||||
<value>Предупреждения</value>
|
||||
</data>
|
||||
<data name="botname.AntiAFK" xml:space="preserve">
|
||||
<value>AntiAFK</value>
|
||||
<value>АнтиАФК</value>
|
||||
</data>
|
||||
<data name="botname.AutoAttack" xml:space="preserve">
|
||||
<value>AutoAttack</value>
|
||||
<value>Автоатака</value>
|
||||
</data>
|
||||
<data name="botname.AutoCraft" xml:space="preserve">
|
||||
<value>AutoCraft</value>
|
||||
<value>Автокрафт</value>
|
||||
</data>
|
||||
<data name="botname.AutoDig" xml:space="preserve">
|
||||
<value>AutoDig</value>
|
||||
|
|
@ -970,10 +970,10 @@ Add the ID of this chat to "Authorized_Chat_Ids" field in the configuration file
|
|||
<value>Bot {0} is not loaded, check if you have made a typo!</value>
|
||||
</data>
|
||||
<data name="cmd.bots.unloaded" xml:space="preserve">
|
||||
<value>Successfully unloaded bot: {0}</value>
|
||||
<value>Успешно выгружен бот: {0}</value>
|
||||
</data>
|
||||
<data name="cmd.bots.unloaded_all" xml:space="preserve">
|
||||
<value>Successfully unloaded all bots!</value>
|
||||
<value>Все боты успешно выгружены!</value>
|
||||
</data>
|
||||
<data name="cmd.changeSlot.changed" xml:space="preserve">
|
||||
<value>Изменился на слот {0}</value>
|
||||
|
|
@ -988,26 +988,26 @@ Add the ID of this chat to "Authorized_Chat_Ids" field in the configuration file
|
|||
<value>Не удалось изменить слот: Not a Number</value>
|
||||
</data>
|
||||
<data name="cmd.chunk.chunk_pos" xml:space="preserve">
|
||||
<value>chunk: ({0}, {1}).</value>
|
||||
<value>чанк: {0}, {1}.</value>
|
||||
</data>
|
||||
<data name="cmd.chunk.current" xml:space="preserve">
|
||||
<value>Current location：{0}, chunk: ({1}, {2}).</value>
|
||||
<value>Текущее местоположение：{0}, чанк: ({1}, {2}).</value>
|
||||
</data>
|
||||
<data name="cmd.chunk.desc" xml:space="preserve">
|
||||
<value>Displays the chunk loading status.
|
||||
Change EnableEmoji=false in the settings if the display is confusing.</value>
|
||||
<value>Отображает статус загрузки чанка.
|
||||
Изменение EnableEmoji=false в настройках, если дисплей запущен.</value>
|
||||
</data>
|
||||
<data name="cmd.chunk.for_debug" xml:space="preserve">
|
||||
<value>§x§0This command is used for debugging, make sure you know what you are doing.§r</value>
|
||||
<value>§x§0Эта команда используется для отладки, убедитесь, что вы знаете, что делаете.§r</value>
|
||||
</data>
|
||||
<data name="cmd.chunk.icon" xml:space="preserve">
|
||||
<value>Player:{0}, MarkedChunk:{1}, NotReceived:{2}, Loading:{3}, Loaded:{4}</value>
|
||||
<value>Игрок:{0}, MarkedChunk:{1}, Не получило:{2}, Загрузка:{3}, Загружено:{4}</value>
|
||||
</data>
|
||||
<data name="cmd.chunk.marked" xml:space="preserve">
|
||||
<value>Marked location: </value>
|
||||
<value>Отметить местоположение: </value>
|
||||
</data>
|
||||
<data name="cmd.chunk.outside" xml:space="preserve">
|
||||
<value>§x§0Since the marked chunk is outside the graph, it will not be displayed!§r</value>
|
||||
<value>§x§0Поскольку отмеченный чанк находится вне графика, он не отображается!§r</value>
|
||||
</data>
|
||||
<data name="cmd.connect.desc" xml:space="preserve">
|
||||
<value>подключиться к указанному серверу.</value>
|
||||
|
|
@ -1052,31 +1052,31 @@ Change EnableEmoji=false in the settings if the display is confusing.</value>
|
|||
<value>Неизвестный предмет {0}</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.clicked" xml:space="preserve">
|
||||
<value>Sent a click to the server, if you have enough levels and if you have placed the items in the correct slots it should enchant!</value>
|
||||
<value>Послал клик на сервер, если у вас достаточно уровней, и если вы разместили предметы в правильные ячейки, то он должен зачароваться!</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.desc" xml:space="preserve">
|
||||
<value>Enchant an item when you have the Enchantment table opened and the list of enchants recieved.</value>
|
||||
<value>Зачаровать предмет, когда вы открыли стол зачарования и список зачарований.</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.enchanting_no_item" xml:space="preserve">
|
||||
<value>You must put an item inside the enchanting table in slot 0!</value>
|
||||
<value>Вы должны поместить предмет в чарующий стол в ячейку 0!</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.enchanting_no_lapis" xml:space="preserve">
|
||||
<value>You must put at least 3 lapis lazuli inside the enchanting table in slot 1!</value>
|
||||
<value>Вы должны положить по крайней мере 3 лазурита внутри очаровательного стола в слот 1!</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.enchanting_table_not_opened" xml:space="preserve">
|
||||
<value>You must open a an enchanting table in order to use this option!</value>
|
||||
<value>Вы должны открыть чарующий стол, чтобы использовать этот вариант!</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.invalid_slot" xml:space="preserve">
|
||||
<value>Invalid slot provided (Available: top, middle, bottom)!</value>
|
||||
<value>Предоставлен недопустимый слот (Даёт: сверху, средний, внизу)!</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.no_enchantments" xml:space="preserve">
|
||||
<value>You must first put an item to enchant to the enchanting table in order to get enchantments from the server, then you can execute this command!</value>
|
||||
<value>Вы должны сначала поместить предмет, чтобы зачаровать его в чарующие столы, чтобы получить чары с сервера, тогда вы можете выполнить эту команду!</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.no_levels" xml:space="preserve">
|
||||
<value>You do not have enouhg levels to enchant! (Your current level is {0}, you need to be level {1}).</value>
|
||||
<value>У вас нет уровней заклинания для чаров! (Ваш текущий уровень - {0}, вам нужен {1} уровень).</value>
|
||||
</data>
|
||||
<data name="cmd.enchant.not_clicked" xml:space="preserve">
|
||||
<value>Could not click!</value>
|
||||
<value>Не удалось нажать!</value>
|
||||
</data>
|
||||
<data name="cmd.entityCmd.attacked" xml:space="preserve">
|
||||
<value>Сущность атакована</value>
|
||||
|
|
@ -1109,7 +1109,7 @@ Change EnableEmoji=false in the settings if the display is confusing.</value>
|
|||
<value>Шлем</value>
|
||||
</data>
|
||||
<data name="cmd.entityCmd.item" xml:space="preserve">
|
||||
<value>Item</value>
|
||||
<value>Предмет</value>
|
||||
</data>
|
||||
<data name="cmd.entityCmd.latency" xml:space="preserve">
|
||||
<value>Задержка</value>
|
||||
|
|
@ -1136,94 +1136,94 @@ Change EnableEmoji=false in the settings if the display is confusing.</value>
|
|||
<value>Поза</value>
|
||||
</data>
|
||||
<data name="cmd.entityCmd.type" xml:space="preserve">
|
||||
<value>Type</value>
|
||||
<value>Тип</value>
|
||||
</data>
|
||||
<data name="cmd.entityCmd.used" xml:space="preserve">
|
||||
<value>Существо использовано</value>
|
||||
</data>
|
||||
<data name="cmd.execif.desc" xml:space="preserve">
|
||||
<value>Allows you to execute a command if a condition is met. (You can use variables from MinecraftClient.ini and /set command, as well as CSharp expressions)</value>
|
||||
<value>Позволяет выполнить команду, если условие выполнено. (Вы можете использовать переменные из команды MinecraftClient.ini и /set и CSharp)</value>
|
||||
</data>
|
||||
<data name="cmd.execif.error" xml:space="preserve">
|
||||
<value>Error: {0}</value>
|
||||
<value>Ошибка: {0}</value>
|
||||
</data>
|
||||
<data name="cmd.execif.error_occured" xml:space="preserve">
|
||||
<value>An error has occured while executing the command: {0}</value>
|
||||
<value>Произошла ошибка при выполнении команды: {0}</value>
|
||||
</data>
|
||||
<data name="cmd.execif.executed" xml:space="preserve">
|
||||
<value>The condition '{0}' was met, executed command '{1}' with result '{2}'.</value>
|
||||
<value>Условие '{0}' выполнено, выполнена команда '{1}' с результатом '{2}'.</value>
|
||||
</data>
|
||||
<data name="cmd.execif.executed_no_output" xml:space="preserve">
|
||||
<value>The condition '{0}' was met, executed command '{1}', no result was returned.</value>
|
||||
<value>Условие '{0}' выполнено, выполнена команда '{1}', результат не был возвращен.</value>
|
||||
</data>
|
||||
<data name="cmd.execmulti.desc" xml:space="preserve">
|
||||
<value>Execute multiple commands one after another</value>
|
||||
<value>Выполнять несколько команд одна за другой</value>
|
||||
</data>
|
||||
<data name="cmd.execmulti.executed" xml:space="preserve">
|
||||
<value>Executed the command '{0}' with {1}</value>
|
||||
<value>Выполнена команда '{0}' ' ' с {1}</value>
|
||||
</data>
|
||||
<data name="cmd.execmulti.no_result" xml:space="preserve">
|
||||
<value>no result!</value>
|
||||
<value>нет результатов!</value>
|
||||
</data>
|
||||
<data name="cmd.execmulti.result" xml:space="preserve">
|
||||
<value>result '{0}'!</value>
|
||||
<value>результат '{0}'!</value>
|
||||
</data>
|
||||
<data name="cmd.exit.desc" xml:space="preserve">
|
||||
<value>отключиться от сервера.</value>
|
||||
</data>
|
||||
<data name="cmd.follow.already_following" xml:space="preserve">
|
||||
<value>Already following {0}!</value>
|
||||
<value>Уже преследую {0}!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.already_stopped" xml:space="preserve">
|
||||
<value>Already stopped</value>
|
||||
<value>Уже остановлено</value>
|
||||
</data>
|
||||
<data name="cmd.follow.cant_reach_player" xml:space="preserve">
|
||||
<value>Can not reach the player, he is either in chunks that are not loaded, too far away or not reachable by a bot due to obstacles like gaps or water bodies!</value>
|
||||
<value>Не могу добраться до игрока, он либо в чанках, которые не загружены, Слишком далеко или недоступно ботом из-за таких препятствий, как разрывы или водяные органы!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.desc" xml:space="preserve">
|
||||
<value>Makes the bot follow a specified player</value>
|
||||
<value>Заставляет бота следить за указанным игроком</value>
|
||||
</data>
|
||||
<data name="cmd.follow.invalid_name" xml:space="preserve">
|
||||
<value>Invalid or empty player name provided!</value>
|
||||
<value>Неверное или пустое имя игрока!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.invalid_player" xml:space="preserve">
|
||||
<value>The specified player is either not connected out out of the range!</value>
|
||||
<value>Указанный игрок либо не подключен за пределы диапазона!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.note" xml:space="preserve">
|
||||
<value>NOTE: The bot is quite slow, you need to walk slowly and at a close distance for it to be able to keep up, kinda like when you make animals follow you by holding food in your hand. This is a limitation due to a pathfinding algorithm, we are working to get a better one.</value>
|
||||
<value>ПРИМЕЧАНИЕ: Бот довольно медленно, вам нужно двигаться медленно и на близком расстоянии, чтобы он мог идти дальше, добро пожаловать как когда вы заводите животных следуйте за вами, держав пищу в руке. Это ограничение из-за алгоритма поиска путей, мы работаем над получением лучшего.</value>
|
||||
</data>
|
||||
<data name="cmd.follow.pausing" xml:space="preserve">
|
||||
<value>Pausing!</value>
|
||||
<value>Пауза!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.player_came_to_the_range" xml:space="preserve">
|
||||
<value>The player {0} came back to the range!</value>
|
||||
<value>Игрок {0} вернулся в зону!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.player_left" xml:space="preserve">
|
||||
<value>The player {0} left the server!</value>
|
||||
<value>Игрок {0} покинул сервер!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.player_left_the_range" xml:space="preserve">
|
||||
<value>The player {0} has left the range!</value>
|
||||
<value>Игрок {0} покинул радиус!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.resuming" xml:space="preserve">
|
||||
<value>Resuming to follow!</value>
|
||||
<value>Возобновление приследования!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.started" xml:space="preserve">
|
||||
<value>Started following {0}!</value>
|
||||
<value>Начал приследование {0}!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.stopped" xml:space="preserve">
|
||||
<value>Stopped!</value>
|
||||
<value>Остановлено!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.stopping" xml:space="preserve">
|
||||
<value>Stopped following!</value>
|
||||
<value>Преследование остановлено!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.switched" xml:space="preserve">
|
||||
<value>Switched to following {0}!</value>
|
||||
<value>Переключено на {0}!</value>
|
||||
</data>
|
||||
<data name="cmd.follow.unsafe_enabled" xml:space="preserve">
|
||||
<value>Enabled us-safe walking (NOTE: The bot might die or get hurt!)</value>
|
||||
<value>Включена "Безопасная прогулка" (ПРИМЕЧАНИЕ: бот может погибнуть или навредить себе!)</value>
|
||||
</data>
|
||||
<data name="cmd.follow.usage" xml:space="preserve">
|
||||
<value>follow <player name|stop> [-f] (Use -f to enable un-safe walking)</value>
|
||||
<value>следуйте за <player name|stop> [-f] (Используйте -f для включения небезопасной ходьбы)</value>
|
||||
</data>
|
||||
<data name="cmd.health.desc" xml:space="preserve">
|
||||
<value>Показать здоровье и насыщенность пищей.</value>
|
||||
|
|
@ -1265,7 +1265,7 @@ Change EnableEmoji=false in the settings if the display is confusing.</value>
|
|||
<value>Выбросил всю стопку предметов из слота #{0}</value>
|
||||
</data>
|
||||
<data name="cmd.inventory.found_items" xml:space="preserve">
|
||||
<value>Found items</value>
|
||||
<value>Найденные предметы</value>
|
||||
</data>
|
||||
<data name="cmd.inventory.help.available" xml:space="preserve">
|
||||
<value>Доступные действия</value>
|
||||
|
|
@ -1295,7 +1295,7 @@ Change EnableEmoji=false in the settings if the display is confusing.</value>
|
|||
Note that parameters in '[]' are optional.</value>
|
||||
</data>
|
||||
<data name="cmd.inventory.help.inventories" xml:space="preserve">
|
||||
<value>List avaliable inventories</value>
|
||||
<value>Список доступных инвентарей</value>
|
||||
</data>
|
||||
<data name="cmd.inventory.help.list" xml:space="preserve">
|
||||
<value>Список инвентаря.</value>
|
||||
|
|
@ -1578,195 +1578,195 @@ You need to enable Entity Handling to use this bot
|
|||
<value>Possible values: "Interact", "Attack" (default), "InteractAt" (Interact and Attack).</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoAttack.List_Mode" xml:space="preserve">
|
||||
<value>Wether to treat the entities list as a "whitelist" or as a "blacklist".</value>
|
||||
<value>Ведь мы рассматриваем список сущностей как «белый» или «черный список».</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoAttack.Mode" xml:space="preserve">
|
||||
<value>"single" or "multi". single target one mob per attack. multi target all mobs in range per attack</value>
|
||||
<value>«одиночный» или «мульти». одиночная цель по одному мобу за атаку. Уничтожайте всех мобов в радиусе действия за атаку</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoAttack.Priority" xml:space="preserve">
|
||||
<value>"health" or "distance". Only needed when using single mode</value>
|
||||
<value>"здоровье" или "расстояние". Требуется только при использовании единого режима</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoCraft" xml:space="preserve">
|
||||
<value>Automatically craft items in your inventory
|
||||
See https://mccteam.github.io/guide/chat-bots.html#auto-craft for how to use
|
||||
You need to enable Inventory Handling to use this bot
|
||||
You should also enable Terrain and Movements if you need to use a crafting table</value>
|
||||
<value>Автоматически создавать предметы в вашем инвентаре
|
||||
Смотрите https://mccteam.github.io/guide/chat-bots. tml#auto-craft для использования
|
||||
вам нужно включить обработку инвентаря, чтобы использовать этого бота
|
||||
Вы также должны включить ландшафт и движения, если вам нужно использовать таблицу крафта</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoCraft.CraftingTable" xml:space="preserve">
|
||||
<value>Location of the crafting table if you intended to use it. Terrain and movements must be enabled.</value>
|
||||
<value>Местоположение таблицы крафта, если вы хотите использовать его. Необходимо включить ландшафт и движения.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoCraft.OnFailure" xml:space="preserve">
|
||||
<value>What to do on crafting failure, "abort" or "wait".</value>
|
||||
<value>Что делать при сбое создания, "прервать" или "ждать".</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoCraft.Recipes" xml:space="preserve">
|
||||
<value>Recipes.Name: The name can be whatever you like and it is used to represent the recipe.
|
||||
Recipes.Type: crafting table type: "player" or "table"
|
||||
Recipes.Result: the resulting item
|
||||
Recipes.Slots: All slots, counting from left to right, top to bottom. Please fill in "Null" for empty slots.
|
||||
For the naming of the items, please see:
|
||||
<value>Рецепты.Имя: Имя может быть всем, что вам нравится, и используется для представления рецепта.
|
||||
Рецепты. ype: Тип таблицы создания: "игрок" или "таблица"
|
||||
Рецепты. Результат: получившийся предмет
|
||||
Рецепт. партии: Все слоты, считающие слева направо, сверху вниз. Пожалуйста, заполните «Null» для пустых слотов.
|
||||
Названия предметов см.
|
||||
https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig" xml:space="preserve">
|
||||
<value>Auto-digging blocks.
|
||||
You need to enable Terrain Handling to use this bot
|
||||
You can use "/digbot start" and "/digbot stop" to control the start and stop of AutoDig.
|
||||
Since MCC does not yet support accurate calculation of the collision volume of blocks, all blocks are considered as complete cubes when obtaining the position of the lookahead.
|
||||
For the naming of the block, please see https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/Material.cs</value>
|
||||
<value>Блоки автоматического поиска.
|
||||
Вам нужно включить обработку местности для использования этого бота
|
||||
Вы можете использовать "/digbot start" и "/digbot stop" для управления стартом и остановкой AutoDig.
|
||||
Поскольку MCC еще не поддерживает точный расчет объема столкновений блоков, все кварталы считаются завершёнными кубиками при получении позиции lookahead.
|
||||
Названия блока можно найти на https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/Material.cs</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Auto_Start_Delay" xml:space="preserve">
|
||||
<value>How many seconds to wait after entering the game to start digging automatically, set to -1 to disable automatic start.</value>
|
||||
<value>Сколько секунд ждать после входа в игру начнёт рычать автоматически, установите -1 для отключения автоматического запуска.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Auto_Tool_Switch" xml:space="preserve">
|
||||
<value>Automatically switch to the appropriate tool.</value>
|
||||
<value>Автоматически переключайтесь на соответствующий инструмент.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Dig_Timeout" xml:space="preserve">
|
||||
<value>Mining a block for more than "Dig_Timeout" seconds will be considered a timeout.</value>
|
||||
<value>Добыча блока на более чем "Dig_Timeout" секунд будет считаться таймаут.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Drop_Low_Durability_Tools" xml:space="preserve">
|
||||
<value>Whether to drop the current tool when its durability is too low.</value>
|
||||
<value>Отбрасывать текущий инструмент, когда его прочность слишком мала.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Durability_Limit" xml:space="preserve">
|
||||
<value>Will not use tools with less durability than this. Set to zero to disable this feature.</value>
|
||||
<value>Не будет использовать инструменты с меньшей прочностью. Установите 0, чтобы отключить эту функцию.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.List_Type" xml:space="preserve">
|
||||
<value>Wether to treat the blocks list as a "whitelist" or as a "blacklist".</value>
|
||||
<value>Ведь список блоков рассматривается как "белый список" или как "черный список".</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Location_Order" xml:space="preserve">
|
||||
<value>"distance" or "index", When using the "fixedpos" mode, the blocks are determined by distance to the player, or by the order in the list.</value>
|
||||
<value>"Расстояние" или "индекс", при использовании режима "фиксированные" блоки определяются по расстоянию до игрока или по порядку в списке.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Locations" xml:space="preserve">
|
||||
<value>The position of the blocks when using "fixedpos" or "both" mode.</value>
|
||||
<value>Положение блоков при использовании "фиксированных" или "обоих" режимов.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Log_Block_Dig" xml:space="preserve">
|
||||
<value>Whether to output logs when digging blocks.</value>
|
||||
<value>Выводить журналы при копании блоков.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDig.Mode" xml:space="preserve">
|
||||
<value>"lookat", "fixedpos" or "both". Digging the block being looked at, the block in a fixed position, or the block that needs to be all met.</value>
|
||||
<value>«взгляд», «фиксированные» или «обои». Подогнать посмотревший блок, блок в фиксированном положении, или блок, который должен быть полностью удовлетворен.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDrop" xml:space="preserve">
|
||||
<value>Automatically drop items in inventory
|
||||
You need to enable Inventory Handling to use this bot
|
||||
See this file for an up-to-date list of item types you can use with this bot:
|
||||
https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs</value>
|
||||
<value>Автоматически выбрасывать предметы в инвентарь
|
||||
Вам нужно включить обработку инвентаря для использования этого бота
|
||||
Смотрите этот файл для обновленного списка типов предметов вы можете использовать вместе с этим ботом:
|
||||
https://github. om/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Invent/ItemType.cs</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDrop.Mode" xml:space="preserve">
|
||||
<value>"include", "exclude" or "everything". Include: drop item IN the list. Exclude: drop item NOT IN the list</value>
|
||||
<value>Включите, чтобы включить "включительно", "исключить" или "всего". Включает: выбросить элемент в список. Исключить: исключить элемент НЕ В списке</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoEat" xml:space="preserve">
|
||||
<value>Automatically eat food when your Hunger value is low
|
||||
You need to enable Inventory Handling to use this bot</value>
|
||||
<value>Автоматически съедайте еду, когда ваш голод имеет низкое значение
|
||||
Вам нужно включить обработку инвентаря, чтобы использовать этого бота</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing" xml:space="preserve">
|
||||
<value>Automatically catch fish using a fishing rod
|
||||
Guide: https://mccteam.github.io/guide/chat-bots.html#auto-fishing
|
||||
You can use "/fish" to control the bot manually.
|
||||
/!\ Make sure server rules allow automated farming before using this bot</value>
|
||||
<value>Автоматически ловить рыбу, используя удочку
|
||||
Руководство: https://mccteam.github.io/guide/chat-bots. tml#auto-fishing
|
||||
Вы можете использовать "/fish" для ручного управления ботом.
|
||||
/!\ Убедитесь, что правила сервера позволяют автоматическое земледелие перед использованием этого бота</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Antidespawn" xml:space="preserve">
|
||||
<value>Keep it as false if you have not changed it before.</value>
|
||||
<value>Сохраните это как ложь, если вы не изменили его раньше.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Auto_Rod_Switch" xml:space="preserve">
|
||||
<value>Switch to a new rod from inventory after the current rod is unavailable.</value>
|
||||
<value>Переключиться на новую удочку из инвентаря после того, как текущая удочка недоступна.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Auto_Start" xml:space="preserve">
|
||||
<value>Whether to start fishing automatically after entering a world.</value>
|
||||
<value>Начинать рыбалку автоматически после входа в мир.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Cast_Delay" xml:space="preserve">
|
||||
<value>How soon to re-cast after successful fishing.</value>
|
||||
<value>Как быстро заново забросить после успешного клюва.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Durability_Limit" xml:space="preserve">
|
||||
<value>Will not use rods with less durability than this (full durability is 64). Set to zero to disable this feature.</value>
|
||||
<value>Не будет использовать удочки с меньшей прочностью (полная прочность 64). Установите ноль, чтобы отключить эту функцию.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Enable_Move" xml:space="preserve">
|
||||
<value>This allows the player to change position/facing after each fish caught.</value>
|
||||
<value>Это позволяет игроку изменить положение или положение перед каждой рыбной ловлей.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Fishing_Delay" xml:space="preserve">
|
||||
<value>How long after entering the game to start fishing (seconds).</value>
|
||||
<value>Как долго после входа в игру начать рыбалку (в секундах).</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Fishing_Timeout" xml:space="preserve">
|
||||
<value>Fishing timeout (seconds). Timeout will trigger a re-cast.</value>
|
||||
<value>Тайм-аут рыбалки (в секундах). Тайм-аут вызовет повторный выстрел.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Hook_Threshold" xml:space="preserve">
|
||||
<value>A "stationary" hook that moves above this threshold in the Y-axis will be considered to have caught a fish.</value>
|
||||
<value>"Неподвижный" крюк, который движется выше этого порога в оси Y, будет считаться пойманным рыбу.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Log_Fish_Bobber" xml:space="preserve">
|
||||
<value>Used to adjust the above two thresholds, which when enabled will print the change in the position of the fishhook entity upon receipt of its movement packet.</value>
|
||||
<value>Используется для регулировки выше двух пороговых значений,, который при включении будет напечатать изменения в положении рыболовецкой сущности после получения ее передвижения.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Mainhand" xml:space="preserve">
|
||||
<value>Use the mainhand or the offhand to hold the rod.</value>
|
||||
<value>Используйте mainhand или offhand для удержания стержня.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Movements" xml:space="preserve">
|
||||
<value>It will move in order "1->2->3->4->3->2->1->2->..." and can change position or facing or both each time. It is recommended to change the facing only.</value>
|
||||
<value>Порядок "1->2->3->4->3->2->1->2->. " и может изменять положение или облицовку или обе стороны. Рекомендуется изменить только облицовочное положение.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Stationary_Threshold" xml:space="preserve">
|
||||
<value>Hook movement in the X and Z axis less than this value will be considered stationary.</value>
|
||||
<value>Движение крюка по оси X и Z меньше, чем это значение будет считаться стационарным.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoRelog" xml:space="preserve">
|
||||
<value>Automatically relog when disconnected by server, for example because the server is restating
|
||||
/!\ Use Ignore_Kick_Message=true at own risk! Server staff might not appreciate if you auto-relog on manual kicks</value>
|
||||
<value>Автоматически перерегистрировать при отключении сервера, например, потому что сервер снова
|
||||
/! Использовать Ignore_Kick_Message=true на свой риск! Сотрудники сервера могут не оценить, если вы автоматически переходите в систему вручную</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoRelog.Delay" xml:space="preserve">
|
||||
<value>The delay time before joining the server. (in seconds)</value>
|
||||
<value>Задержка при подключении к серверу. (в секундах)</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoRelog.Ignore_Kick_Message" xml:space="preserve">
|
||||
<value>When set to true, autorelog will reconnect regardless of kick messages.</value>
|
||||
<value>Если установлено значение true, то авторелог будет переподключаться вне зависимости от ударов сообщений.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoRelog.Kick_Messages" xml:space="preserve">
|
||||
<value>If the kickout message matches any of the strings, then autorelog will be triggered.</value>
|
||||
<value>Если выпадающее сообщение совпадает с любой из строк, то будет срабатывать авторелог.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoRelog.Retries" xml:space="preserve">
|
||||
<value>Retries when failing to relog to the server. use -1 for unlimited retries.</value>
|
||||
<value>Повторяет при сбое записи на сервер. Используйте -1 для неограниченного просмотра.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoRespond" xml:space="preserve">
|
||||
<value>Run commands or send messages automatically when a specified pattern is detected in chat
|
||||
Server admins can spoof chat messages (/nick, /tellraw) so keep this in mind when implementing AutoRespond rules
|
||||
/!\ This bot may get spammy depending on your rules, although the global messagecooldown setting can help you avoiding accidental spam</value>
|
||||
<value>Выполняйте команды или отправляйте сообщения автоматически при обнаружении указанного шаблона в чате
|
||||
Администраторы сервера могут воспринимать сообщения чата (/nick, /tellraw) так что помните об этом при внедрении правил AutoRespond
|
||||
/! Этот бот может получить спам в зависимости от ваших правил, хотя глобальный параметр messagecooldown может помочь вам избежать случайного спама</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoRespond.Match_Colors" xml:space="preserve">
|
||||
<value>Do not remove colors from text (Note: Your matches will have to include color codes (ones using the § character) in order to work)</value>
|
||||
<value>Не удаляйте цвета из текста (Примечание: ваши совпадения будут включать цветовые коды (те, которые используют § символ) для работы)</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.ChatLog" xml:space="preserve">
|
||||
<value>Logs chat messages in a file on disk.</value>
|
||||
<value>Записывает сообщения чата в файле на диске.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.DiscordBridge" xml:space="preserve">
|
||||
<value>This bot allows you to send and recieve messages and commands via a Discord channel.
|
||||
For Setup you can either use the documentation or read here (Documentation has images).
|
||||
Documentation: https://mccteam.github.io/guide/chat-bots.html#discord-bridge
|
||||
Setup:
|
||||
First you need to create a Bot on the Discord Developers Portal, here is a video tutorial: https://www.youtube.com/watch?v=2FgMnZViNPA .
|
||||
/!\ IMPORTANT /!\: When creating a bot, you MUST ENABLE "Message Content Intent", "Server Members Intent" and "Presence Intent" in order for bot to work! Also follow along carefully do not miss any steps!
|
||||
When making a bot, copy the generated token and paste it here in "Token" field (tokens are important, keep them safe).
|
||||
Copy the "Application ID" and go to: https://bit.ly/2Spn2Q3 .
|
||||
Paste the id you have copied and check the "Administrator" field in permissions, then click on the link at the bottom.
|
||||
This will open an invitation menu with your servers, choose the server you want to invite the bot on and invite him.
|
||||
Once you've invited the bot, go to your Discord client and go to Settings -> Advanced and Enable "Developer Mode".
|
||||
Exit the settings and right click on a server you have invited the bot to in the server list, then click "Copy ID", and paste the id here in "GuildId".
|
||||
Then right click on a channel where you want to interact with the bot and again right click -> "Copy ID", pase the copied id here in "ChannelId".
|
||||
And for the end, send a message in the channel, right click on your nick and again right click -> "Copy ID", then paste the id here in "OwnersIds".
|
||||
How to use:
|
||||
To execute an MCC command, prefix it with a dot ".", example: ".move 143 64 735" .
|
||||
To send a message, simply type it out and hit enter.</value>
|
||||
<value>Этот бот позволяет вам отправлять и получать сообщения и команды через канал Discord.
|
||||
Для установки вы можете использовать документацию или прочитать здесь (Документация имеет изображения).
|
||||
Документация: https://mccteam. ithub.io/guide/chat-bots.html#discord-bridge
|
||||
Настройка:
|
||||
Сначала вам нужно создать бота на портале разработчиков Discord, смотрите видео-урок: https://www.youtube.com/watch?v=2FgMnZViNPA .
|
||||
/!\ ВАЖНОЙ /! : При создании бота, вы ДОЛЖНЫ ВКЛЮЧИТЬ "Содержимое сообщения", "Intent" и "Presence Intent" в целях работы бота! Также следуйте осторожно, не пропустите никаких шагов!
|
||||
При создании бота скопируйте сгенерированный токен и вставьте его здесь, в поле "Token" (токены важны, сохраняйте их в безопасности).
|
||||
Скопируйте "Application ID" и перейдите по ссылке: https://bit.ly/2Spn2Q3 .
|
||||
Вставьте идентификатор, который вы скопировали и проверьте поле «Администратор» в разрешениях, затем нажмите на ссылку внизу.
|
||||
Это откроет меню приглашений ваших серверов, выберите сервер, на который вы хотите пригласить бота и пригласите его.
|
||||
После того, как вы пригласили бота, перейдите к вашему клиенту Discord и перейдите в Настройки -> Расширенные и включите "Режим разработчика".
|
||||
Выйдите из настроек и щелкните правой кнопкой мыши на сервере, который вы пригласили бота в список серверов, затем нажмите "Copy ID" и вставьте идентификатор здесь в "GuildId".
|
||||
Затем нажмите правой кнопкой мыши на канале, где вы хотите взаимодействовать с ботом и правой кнопкой мыши -> "Copy ID", поместите здесь скопированный идентификатор в "ChannelId".
|
||||
И на конце, отправьте сообщение в канале, щелкните правой кнопкой мыши по ник и снова правой кнопкой мыши -> "Copy ID", затем вставьте идентификатор здесь в "OwnersIds".
|
||||
Как использовать:
|
||||
Для выполнения MCC команды, префикс с точкой". , пример: ".move 143 64 735" .
|
||||
Чтобы отправить сообщение, просто введите его и нажмите enter.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.DiscordBridge.ChannelId" xml:space="preserve">
|
||||
<value>The ID of a channel where you want to interact with the MCC using the bot.</value>
|
||||
<value>ID канала, в котором вы хотите взаимодействовать с MCC с помощью бота.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.DiscordBridge.Formats" xml:space="preserve">
|
||||
<value>Message formats
|
||||
Words wrapped with { and } are going to be replaced during the code execution, do not change them!
|
||||
For example. {message} is going to be replace with an actual message, {username} will be replaced with an username, {timestamp} with the current time.
|
||||
For Discord message formatting, check the following: https://bit.ly/3F8CUCm</value>
|
||||
<value>Форматы сообщений
|
||||
Слова, завернутые на { and } , будут заменены во время выполнения кода, не меняйте их!
|
||||
Например: {message} будет заменен фактическим сообщением, {username} будет заменено на имя пользователя {timestamp} текущим временем.
|
||||
Для форматирования сообщений Discord проверьте следующее: https://bit.ly/3F8CUCm</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.DiscordBridge.GuildId" xml:space="preserve">
|
||||
<value>The ID of a server/guild where you have invited the bot to.</value>
|
||||
<value>ID сервера/гильдии, куда вы пригласили бота.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.DiscordBridge.MessageSendTimeout" xml:space="preserve">
|
||||
<value>How long to wait (in seconds) if a message can not be sent to discord before canceling the task (minimum 1 second).</value>
|
||||
<value>Как долго ждать (в секундах), если сообщение не может быть отправлено в discord перед отменой задачи (минимум 1 секунда).</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.DiscordBridge.OwnersIds" xml:space="preserve">
|
||||
<value>A list of IDs of people you want to be able to interact with the MCC using the bot.</value>
|
||||
<value>Список идентификаторов людей, которые вы хотите иметь возможность взаимодействовать с MCC с помощью бота.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.DiscordBridge.Token" xml:space="preserve">
|
||||
<value>Your Discord Bot token.</value>
|
||||
<value>Ваш токен бота Discord.</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.Farmer" xml:space="preserve">
|
||||
<value>Automatically farms crops for you (plants, breaks and bonemeals them).
|
||||
|
|
@ -2332,7 +2332,7 @@ If the connection to the Minecraft game server is blocked by the firewall, set E
|
|||
<value>Не удается подключиться к серверу: эта версия не поддерживается!</value>
|
||||
</data>
|
||||
<data name="error.usage" xml:space="preserve">
|
||||
<value>Usage:</value>
|
||||
<value>Применение:</value>
|
||||
</data>
|
||||
<data name="error.version_different" xml:space="preserve">
|
||||
<value>§8Сервер сообщает о версии, отличной от установленной вручную. Вход в систему может не работать.</value>
|
||||
|
|
|
|||
|
|
@ -130,7 +130,7 @@
|
|||
<value>§cHava değişikliği: Fırtınalı başlandı.§r</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.invalid_walk_range" xml:space="preserve">
|
||||
<value>Sağlanan geçersiz yürüyüş aralığı, varsayılan 5 değeri kullanılarak 0dan büyük bir pozitif tam sayı olmalıdır!</value>
|
||||
<value>Geçersiz yürüyüş mesafesi, varsayılan 5 değeri kullanın veya 0dan büyük bir sayı belirleyin!</value>
|
||||
</data>
|
||||
<data name="bot.antiafk.not_using_terrain_handling" xml:space="preserve">
|
||||
<value>İstemci ayarlarında terrain and movement etkin değil, bu botla kullanmak istiyorsanız etkinleştirin. Alternatif (komut) yöntemini kullanma.</value>
|
||||
|
|
@ -166,10 +166,10 @@
|
|||
<value>Üretim başarısız oldu! Daha fazla malzeme bekliyorum</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.debug.no_config" xml:space="preserve">
|
||||
<value>Yapılandırma bulunamadı. Yenisini yazın.</value>
|
||||
<value>Ayarlar bulunamadı. Yenisini yazın.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.error.config" xml:space="preserve">
|
||||
<value>Yapılandırma ayrıştırılırken hata oluştu: {0}</value>
|
||||
<value>Ayarlar okunurken hata oluştu: {0}</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.exception.duplicate" xml:space="preserve">
|
||||
<value>Belirtilen yinelenen tarif adı: {0}</value>
|
||||
|
|
@ -184,10 +184,10 @@
|
|||
<value>Mevcut tarifleri listeleyin.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.load" xml:space="preserve">
|
||||
<value>Yapılandırma dosyasını yükleyin.</value>
|
||||
<value>Ayar dosyasını yükleyin.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.reload" xml:space="preserve">
|
||||
<value>Yapılandırma dosyasını yeniden yükleyin.</value>
|
||||
<value>Ayar dosyasını yeniden yükleyin.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.resetcfg" xml:space="preserve">
|
||||
<value>Varsayılan örnek yapılandırmayı varsayılan konuma yazın.</value>
|
||||
|
|
@ -196,7 +196,7 @@
|
|||
<value>İşçiliği başlatın. Kullanım: /autocraft start <recipe name></value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.help.stop" xml:space="preserve">
|
||||
<value>Mevcut çalışan işçiliği işlemini durdur</value>
|
||||
<value>Mevcut üretimi durdurun</value>
|
||||
</data>
|
||||
<data name="bot.autocraft.invaild_result" xml:space="preserve">
|
||||
<value>Geçersiz sonuç öğesi!</value>
|
||||
|
|
@ -214,7 +214,7 @@
|
|||
<value>Lütfen oluşturmak istediğiniz tarifin adını belirtin.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.recipe_not_exist" xml:space="preserve">
|
||||
<value>Belirtilen tarif adı mevcut değil. Yapılandırma dosyanızı kontrol edin.</value>
|
||||
<value>Belirtilen tarif adı mevcut değil. Ayar dosyanızı kontrol edin.</value>
|
||||
</data>
|
||||
<data name="bot.autoCraft.start" xml:space="preserve">
|
||||
<value>AutoCraft başlatılıyor: {0}</value>
|
||||
|
|
@ -278,7 +278,7 @@
|
|||
{1}</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.no_inventory" xml:space="preserve">
|
||||
<value>{0} envanteri bulunamıyor!</value>
|
||||
<value>Envanter {0} bulunamıyor!</value>
|
||||
</data>
|
||||
<data name="bot.autoDrop.no_item" xml:space="preserve">
|
||||
<value>Listede öğe yok</value>
|
||||
|
|
@ -347,10 +347,10 @@
|
|||
<value>Mevcut olta mevcut değil. Belki kırık veya düşük dayanıklılık?</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.start" xml:space="preserve">
|
||||
<value>auto-fishing başlatır.</value>
|
||||
<value>auto-fishing başlat.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.start_at" xml:space="preserve">
|
||||
<value>Balık avı {0:0.0} saniye içinde başlayacak.</value>
|
||||
<value>Balık tutmaya {0:0.0} saniye içinde başlayacak.</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.status_clear" xml:space="preserve">
|
||||
<value>Elde edilen eşyaların kaydı temizlendi.</value>
|
||||
|
|
@ -553,7 +553,7 @@ cooldown: {6}</value>
|
|||
<value>Yeni veritabanı dosyası oluşturma: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.create.ignore" xml:space="preserve">
|
||||
<value>Yeni ignore listesi oluşturma: {0}</value>
|
||||
<value>Yeni yok sayma listesi oluşturuluyor: {0}</value>
|
||||
</data>
|
||||
<data name="bot.mailer.delivered" xml:space="preserve">
|
||||
<value>Teslim edildi: {0}</value>
|
||||
|
|
@ -2652,24 +2652,24 @@ Giriş yapılıyor...</value>
|
|||
<value>Lütfen bu Minecraft sürümü için sağlık alanı işlemeyi güncelleyin.</value>
|
||||
</data>
|
||||
<data name="bot.DiscordBridge.disconnected" xml:space="preserve">
|
||||
<value>Successfully disconnected with MCC!</value>
|
||||
<value>MCC ile bağlantınız başarılı bir şekilde kesildi!</value>
|
||||
</data>
|
||||
<data name="cmd.execmulti.prevent" xml:space="preserve">
|
||||
<value>You can not use execmulti or execif within execmulti command!</value>
|
||||
<value>Execmulti komuduyla execmulti ya da execif kullanamazsınız!</value>
|
||||
</data>
|
||||
<data name="cmd.move.desc_force" xml:space="preserve">
|
||||
<value>force unsafe movements like falling or touching fire</value>
|
||||
<value>düşme ve ateşe değme gibi güvenli olmayan haraketlere zorla</value>
|
||||
</data>
|
||||
<data name="bot.autodig.no_inv_handle" xml:space="preserve">
|
||||
<value>Inventory handling is not enabled. Unable to switch tools automatically.</value>
|
||||
<value>Inventory handling aktif değil. Aletler otomatik değiştirilemiyor.</value>
|
||||
</data>
|
||||
<data name="mcc.use_new_config" xml:space="preserve">
|
||||
<value>Please use the newly generated MinecraftClient.ini</value>
|
||||
<value>Lütfen yeni oluşturulan MinecraftClient.ini dosyasını kullanınız.</value>
|
||||
</data>
|
||||
<data name="mcc.backup_old_config" xml:space="preserve">
|
||||
<value>The old MinecraftClient.ini has been backed up as {0}</value>
|
||||
<value>Eski MinecraftClient.ini dosyası {0} olarak yedeklendi</value>
|
||||
</data>
|
||||
<data name="config.Main.Advanced.temporary_fix_badpacket" xml:space="preserve">
|
||||
<value>Temporary fix for Badpacket issue on some servers.</value>
|
||||
<value>Bazı sunucularda Kötü Paket sorunu için geçici düzeltme.</value>
|
||||
</data>
|
||||
</root>
|
||||
|
|
@ -898,7 +898,7 @@ Add the ID of this chat to "Authorized_Chat_Ids" field in the configuration file
|
|||
Some messages won't be properly printed without this file.</value>
|
||||
</data>
|
||||
<data name="chat.request" xml:space="preserve">
|
||||
<value>§8Performing request to {0}</value>
|
||||
<value>§8Đang gửi yêu cầu tới {0}</value>
|
||||
</data>
|
||||
<data name="chatbot.reconnect" xml:space="preserve">
|
||||
<value>[{0}] Disconnecting and Reconnecting to the Server</value>
|
||||
|
|
|
|||
|
|
@ -1211,7 +1211,7 @@ Add the ID of this chat to "Authorized_Chat_Ids" field in the configuration file
|
|||
<value>开始跟随 {0}！</value>
|
||||
</data>
|
||||
<data name="cmd.follow.stopped" xml:space="preserve">
|
||||
<value>Stopped!</value>
|
||||
<value>已停止！</value>
|
||||
</data>
|
||||
<data name="cmd.follow.stopping" xml:space="preserve">
|
||||
<value>已停止！</value>
|
||||
|
|
|
|||
|
|
@ -362,7 +362,7 @@
|
|||
<value>停止自動釣魚。</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.switch" xml:space="preserve">
|
||||
<value>切換到位於揹包 {0} 位置的魚竿，剩餘耐用 {1}/64。</value>
|
||||
<value>切換到位於背包 {0} 位置的魚竿，剩餘耐用 {1}/64。</value>
|
||||
</data>
|
||||
<data name="bot.autoFish.throw" xml:space="preserve">
|
||||
<value>拋竿成功。</value>
|
||||
|
|
@ -491,7 +491,7 @@ cooldown: {6}</value>
|
|||
<value>耕作機器人</value>
|
||||
</data>
|
||||
<data name="bot.farmer.invalid_crop_type" xml:space="preserve">
|
||||
<value>提供了無效的農作物類型（可選的類型：Beetroot, Carrot, Melon, Netherwart, Pumpkin, Potato, Wheat）</value>
|
||||
<value>提供了無效的農作物類型（可選的類型：Beetroot（甜菜根）, Carrot（蘿蔔）, Melon（西瓜）, Netherwart（地獄疙瘩）, Pumpkin（南瓜）, Potato（馬鈴薯）, Wheat（小麥））</value>
|
||||
</data>
|
||||
<data name="bot.farmer.invalid_radius" xml:space="preserve">
|
||||
<value>提供了無效的半徑。你必須提供一個大於0的整數。</value>
|
||||
|
|
@ -1586,7 +1586,7 @@ cooldown: {6}</value>
|
|||
<value>"health"（生命值）或 "distance"（距離）。當使用"single"模式時，以哪一個屬性確定優先順序。</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoCraft" xml:space="preserve">
|
||||
<value>自動使用揹包中的物品進行合成。
|
||||
<value>自動使用背包中的物品進行合成。
|
||||
請看 https://mccteam.github.io/guide/chat-bots.html#auto-craft
|
||||
你需要啟用庫存處理來使用這個功能
|
||||
如果需要使用工作臺，你還需要啟用地形處理。</value>
|
||||
|
|
@ -1598,7 +1598,8 @@ cooldown: {6}</value>
|
|||
<value>合成失敗時應該怎麼處理，"abort"（中止）或 "wait"（等待）。</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoCraft.Recipes" xml:space="preserve">
|
||||
<value>Recipes.Name：給該配方起一個獨一無二的名字。（不能包含空白字元）Recipes.Type：合成型別，"player"（揹包2x2）或 "table"（工作臺3x3）
|
||||
<value>Recipes.Name：給該配方起一個獨一無二的名字。（不能包含空白字元）
|
||||
Recipes.Type：合成型別，"player"（背包2x2）或 "table"（工作臺3x3）
|
||||
Recipes.Result：合成的目標物品
|
||||
Recipes.Slots：合成的物品擺放方式，以從左到右、從上到下的格式填寫。需留空請填寫"Null"。
|
||||
最新的物品命名請看：https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs</value>
|
||||
|
|
@ -1641,7 +1642,7 @@ Recipes.Slots：合成的物品擺放方式，以從左到右、從上到下的
|
|||
<value>"lookat"，"fixedpos" 或 "both"。挖掘看向的方塊還是固定位置的方塊，或者是兩個條件都滿足的方塊。</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoDrop" xml:space="preserve">
|
||||
<value>自動從揹包/庫存中丟棄指定的物品
|
||||
<value>自動從背包/庫存中丟棄指定的物品
|
||||
你需要啟用庫存處理來使用這個功能。
|
||||
可用物品請看 https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs</value>
|
||||
</data>
|
||||
|
|
@ -1649,7 +1650,7 @@ Recipes.Slots：合成的物品擺放方式，以從左到右、從上到下的
|
|||
<value>"include"（丟棄列表中的物品），"exclude"（丟棄列表外的所有物品） 或 "everything"（丟棄所有物品）</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoEat" xml:space="preserve">
|
||||
<value>在飽食度較低是自動在揹包中尋找食物食用。
|
||||
<value>在飽食度較低是自動在背包中尋找食物食用。
|
||||
你需要啟用庫存處理來使用這個功能。</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing" xml:space="preserve">
|
||||
|
|
@ -1661,7 +1662,7 @@ Recipes.Slots：合成的物品擺放方式，以從左到右、從上到下的
|
|||
<value>如果你之前沒有啟用過這個選項，請保持它為 false 。</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Auto_Rod_Switch" xml:space="preserve">
|
||||
<value>在當前魚竿不可用後自動切換到揹包中的其他魚竿。（需要啟用庫存處理）</value>
|
||||
<value>在當前魚竿不可用後自動切換到背包中的其他魚竿。（需要啟用庫存處理）</value>
|
||||
</data>
|
||||
<data name="config.ChatBot.AutoFishing.Auto_Start" xml:space="preserve">
|
||||
<value>是否在進入伺服器後自動開始釣魚，禁用此功能後，你需要使用"/usehand"手動使用魚竿一次。</value>
|
||||
|
|
@ -1765,9 +1766,9 @@ Recipes.Slots：合成的物品擺放方式，以從左到右、從上到下的
|
|||
</data>
|
||||
<data name="config.ChatBot.Farmer" xml:space="preserve">
|
||||
<value>自動為你耕種農作物（種下，收成和骨粉催生）
|
||||
可用的農作物類型：Beetroot, Carrot, Melon, Netherwart, Pumpkin, Potato, Wheat.
|
||||
可用的農作物類型：Beetroot（甜菜根）, Carrot（蘿蔔）, Melon（西瓜）, Netherwart（地獄疙瘩）, Pumpkin（南瓜）, Potato（馬鈴薯）, Wheat（小麥）
|
||||
使用方法："/farmer start" 指令和 "/farmer stop" 指令。
|
||||
注意：這是新加入的機器人，它不完美並只在 1.19.2 版本進行過測試。它有些小問題，例如有時候不能對蘿蔔或土豆使用骨粉催生；
|
||||
注意：這是新加入的機器人，它不完美並只在 1.19.2 版本進行過測試。它有些小問題，例如有時候不能對蘿蔔或馬鈴薯使用骨粉催生；
|
||||
或機器人會在耕地上跳躍並破壞耕地（這很少發生，但還是有機率出現）。我們期待可以改善它。
|
||||
另外，如果你的耕地只有一格厚，請加厚至兩格以上，否則機器人在重新連線時有可能會穿過耕地並掉落。
|
||||
此外，如果機器人走到邊緣時將不會拾起所有的掉落物，我們已有計劃在未來新增這個選項，同時加入將農作物放到箱子及從箱子補充骨粉。</value>
|
||||
|
|
@ -1989,7 +1990,7 @@ Recipes.Slots：合成的物品擺放方式，以從左到右、從上到下的
|
|||
<value>MCC內部命令的字首，可使用 "none", "slash"(/) 或 "backslash"(\)。</value>
|
||||
</data>
|
||||
<data name="config.Main.Advanced.inventory_handling" xml:space="preserve">
|
||||
<value>啟用庫存處理（可操作揹包、箱子等容器）。</value>
|
||||
<value>啟用庫存處理（可操作背包、箱子等容器）。</value>
|
||||
</data>
|
||||
<data name="config.Main.Advanced.language" xml:space="preserve">
|
||||
<value>請使用Minecraft的語言程式碼填寫，詳見 https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239</value>
|
||||
|
|
@ -2081,7 +2082,7 @@ Recipes.Slots：合成的物品擺放方式，以從左到右、從上到下的
|
|||
<value>帳戶型別：mojang 或是 microsoft。此項設定也會影響互動式登入。</value>
|
||||
</data>
|
||||
<data name="config.MCSettings" xml:space="preserve">
|
||||
<value>下面的設定將會被髮送到遊戲伺服器，隻影響一些伺服器端的東西，比如你的面板。</value>
|
||||
<value>下面的設定將會被發送到遊戲伺服器，只影響一些伺服器端的東西，比如你的皮膚。</value>
|
||||
</data>
|
||||
<data name="config.MCSettings.ChatColors" xml:space="preserve">
|
||||
<value>這允許你在伺服器端禁用聊天顏色。</value>
|
||||
|
|
@ -2659,6 +2660,6 @@ MCC正在使用預設配置執行。</value>
|
|||
<value>已將舊的 MinecraftClient.ini 備份為 {0}</value>
|
||||
</data>
|
||||
<data name="config.Main.Advanced.temporary_fix_badpacket" xml:space="preserve">
|
||||
<value>Temporary fix for Badpacket issue on some servers.</value>
|
||||
<value>某些伺服器上 Badpacket 問題的臨時修補。</value>
|
||||
</data>
|
||||
</root>
|
||||
|
|
@ -12,46 +12,46 @@
|
|||
|
||||
</div>
|
||||
|
||||
## **About ℹ️**
|
||||
## **關於 ℹ️**
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source Minecraft TUI client for **Java** edition that allows you to connect to any Minecraft Java server, send commands and receive text messages in a fast and easy way without having to open the main Minecraft game.
|
||||
**Minecraft 主控台客戶端 (MCC)** 是一个輕量級、跨平台、基於命令列介面的 Minecraft 客戶端，適用於 **Java 版**，允許你連接到任何 Minecraft Java 版伺服器，以快速簡單的方式發送命令與接收文字信息，而無需打開 Minecraft 遊戲。
|
||||
|
||||
## Download
|
||||
## 下載
|
||||
|
||||
Get development builds from the [Releases section](https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest)
|
||||
從 [Releases 頁面](https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest)取得已編譯的開發版程式
|
||||
|
||||
## How to use 📚
|
||||
## 如何使用 📚
|
||||
|
||||
- 🌐 [Full Documentation](https://mccteam.github.io/)
|
||||
- 📦 [Installation](https://mccteam.github.io/guide/installation.html)
|
||||
- 📖 [Usage](https://mccteam.github.io/guide/usage.html)
|
||||
- ⚙️ [Configuration](https://mccteam.github.io/guide/configuration.html)
|
||||
- 🤖 [Chat Bots](https://mccteam.github.io/guide/chat-bots.html)
|
||||
- 📝 [Sample configuration files](MinecraftClient/config/)
|
||||
- 🌐 [完整文檔](https://mccteam.github.io/)
|
||||
- 📦 [安裝](https://mccteam.github.io/guide/installation.html)
|
||||
- 📖 [使用方法](https://mccteam.github.io/guide/usage.html)
|
||||
- ⚙️ [設定](https://mccteam.github.io/guide/configuration.html)
|
||||
- 🤖 [Chat Bots 機器人](https://mccteam.github.io/guide/chat-bots.html)
|
||||
- 📝 [範例設定](MinecraftClient/config/)
|
||||
|
||||
## Getting Help 🙋
|
||||
## 取得幫助 🙋
|
||||
|
||||
Check out the [Website](https://mccteam.github.io/), [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. 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.
|
||||
Check out the [Website](https://mccteam.github.io/), [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. 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. 如果沒有，請建立[新討論串](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/new)來提出你的問題。 如果你找到程式錯誤，請到[問題頁面](https://github.com/MCCTeam/Minecraft-Console-Client/issues)回報。
|
||||
|
||||
## Discord
|
||||
|
||||
We now have a Discord server, click [here](https://discord.gg/sfBv4TtpC9) to join.
|
||||
我們現在有Discord伺服器了，請[按此](https://discord.gg/sfBv4TtpC9)加入。
|
||||
|
||||
## Helping Us ❤️
|
||||
## 幫助我們 ❤️
|
||||
|
||||
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. 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 :)
|
||||
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. 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 :) 我們一直在尋找有動力的人來參與貢獻。 如果你覺得你是那個人，請查看[問題頁面](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+is%3Aopen+label%3Awaiting-for%3Acontributor) :)
|
||||
|
||||
## How to contribute 📝
|
||||
## 如何貢獻 📝
|
||||
|
||||
If you'd like to contribute to Minecraft Console Client, great, just fork the repository and submit a pull request on the _Master_ branch. To contribute to the website / online documentation see also the [Website repository](https://github.com/MCCTeam/MCCTeam.github.io). To contribute to the website / online documentation see also the [Website repository](https://github.com/MCCTeam/MCCTeam.github.io).
|
||||
If you'd like to contribute to Minecraft Console Client, great, just fork the repository and submit a pull request on the _Master_ branch. To contribute to the website / online documentation see also the [Website repository](https://github.com/MCCTeam/MCCTeam.github.io). To contribute to the website / online documentation see also the [Website repository](https://github.com/MCCTeam/MCCTeam.github.io). 如果你希望為網站 / 線上文檔做出貢獻，請參閱[網站的 git 倉庫](https://github.com/MCCTeam/MCCTeam.github.io)。
|
||||
|
||||
|
||||
|
||||
## Translating Minecraft Console Client 🌍
|
||||
## 翻譯 Minecraft Console Client 🌍
|
||||
|
||||
To improve translations for MCC, please visit: [Crowdin - Minecraft Console Client](https://crwd.in/minecraft-console-client).
|
||||
要改進 MCC 的翻譯，請到：[Crowdin - Minecraft Console Client](https://crwd.in/minecraft-console-client)
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
MCC 現在支援以下的語言（按英文字母排序）：
|
||||
* `de.ini` : Deutsch - German
|
||||
* `en.ini` : English - English
|
||||
* `fr.ini` : Français (France) - French
|
||||
|
|
@ -61,16 +61,16 @@ MCC now supports the following languages (Alphabetical order) :
|
|||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
## Building from the source 🏗️
|
||||
## 從原始碼建置 🏗️
|
||||
|
||||
This section has been moved to our new [Documentation website](https://mccteam.github.io/guide/installation.html#building-from-the-source-code).
|
||||
此部分已經移到我們的新[線上文檔](https://mccteam.github.io/guide/installation.html#building-from-the-source-code)。
|
||||
|
||||
## License ⚖️
|
||||
## 許可 ⚖️
|
||||
|
||||
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. The main terms of the CDDL-1.0 license are basically the following: 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:
|
||||
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. The main terms of the CDDL-1.0 license are basically the following: 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: 否則，許可證和原始作者將在原始文件開頭中提及。 CDDL-1.0 許可的主要條款基本上是以下內容：
|
||||
|
||||
- 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. 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. The program itself may be open or closed source, free or commercial. 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. 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.
|
||||
- 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. 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. 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.
|
||||
|
||||
More info at http://qstuff.blogspot.fr/2007/04/why-cddl.html Full license at http://opensource.org/licenses/CDDL-1.0
|
||||
|
|
|
|||
|
|
@ -1,76 +1,76 @@
|
|||
<div align="center">
|
||||
|
||||
<img src="https://i.pics.rs/LLDhE.png" alt="Logo"/>
|
||||
<img src="https://i.pics.rs/LLDhE.png" alt="Логотип"/>
|
||||
|
||||
# Minecraft Console Client (MCC)
|
||||
# Клиент консоли Minecraft (MCC)
|
||||
|
||||
[Documentation](https://mccteam.github.io/) | [Download](#download) | [Installation](https://mccteam.github.io/guide/installation.html) | [Configuration](https://mccteam.github.io/guide/configuration.html) | [Usage](https://mccteam.github.io/guide/usage.html)
|
||||
[Documentation](https://mccteam.github.io/) | [Download](#скачать) | [Installation](https://mccteam.github.io/guide/installation.html) | [Configuration](https://mccteam.github.io/guide/configuration.html) | [Usage](https://mccteam.github.io/guide/usage. tml)
|
||||
|
||||
[English](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README.md) | [Nederlands](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Dutch.md) | [Српски](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Serbian_Cyrillic.md) | [Türkçe](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Turkish.md) | [Tiếng Việt](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Vietnamese.md) | [简体中文](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Chinese_Simplified.md)
|
||||
[English](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README.md) | [Nederlands](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Dutch.md) | [Српски](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Serbian_Cyrillic. d) | [Türkçe](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-Turkish.md) | [Tie<unk> ́ng Vie<unk> <unk> t](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/README/README-README-Vietnamese.md) | [简体中文](https://github.com/MCC/Minecraft-Console-Client/blob/master/README/README-Chinese_Simplified.md)
|
||||
|
||||
[](https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest) <a href="https://discord.gg/sfBv4TtpC9"><img src="https://img.shields.io/discord/1018553894831403028?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
|
||||
[](https://github.com/MCCTeam/Minecraft- <a href="https://discord.gg/sfBv4TtpC9"><img src="https://img.shields.io/discord/1018553894831403028?color=5865F2&logo=discord&logoColor=white" alt="Наш дискорд сервер" /></a>
|
||||
|
||||
</div>
|
||||
|
||||
## **About ℹ️**
|
||||
## **О нас**
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source Minecraft TUI client for **Java** edition that allows you to connect to any Minecraft Java server, send commands and receive text messages in a fast and easy way without having to open the main Minecraft game.
|
||||
**Майнкрафт консольный клиент (MCC)** — лёгкий кросс-платформенный клиент с открытым исходным кодом для версии **Java**, позволяющей подключаться к любому серверу Minecraft, отправка команд и получение текстовых сообщений быстрым и простым способом без открытия основной игры Minecraft.
|
||||
|
||||
## Download
|
||||
## Скачать
|
||||
|
||||
Get development builds from the [Releases section](https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest)
|
||||
Получите тестовые сборки из раздела [Релизы](https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest)
|
||||
|
||||
## How to use 📚
|
||||
## Как пользоваться 📚
|
||||
|
||||
- 🌐 [Full Documentation](https://mccteam.github.io/)
|
||||
- 📦 [Installation](https://mccteam.github.io/guide/installation.html)
|
||||
- 📖 [Usage](https://mccteam.github.io/guide/usage.html)
|
||||
- ⚙️ [Configuration](https://mccteam.github.io/guide/configuration.html)
|
||||
- 🤖 [Chat Bots](https://mccteam.github.io/guide/chat-bots.html)
|
||||
- 📝 [Sample configuration files](MinecraftClient/config/)
|
||||
- 🌐 [Полная документация](https://mccteam.github.io/)
|
||||
- 📦 [Установка](https://mccteam.github.io/guide/installation.html)
|
||||
- 📖 [Использование](https://mccteam.github.io/guide/usage.html)
|
||||
- ⚙️ [Конфигурация](https://mccteam.github.io/guide/configuration.html)
|
||||
- 🤖 [Чат-боты](https://mccteam.github.io/guide/chat-bots.html)
|
||||
- 📝 [Примеры конфигурационных файлов](MinecraftClient/config/)
|
||||
|
||||
## Getting Help 🙋
|
||||
## Получение помощи 🙋
|
||||
|
||||
Check out the [Website](https://mccteam.github.io/), [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.
|
||||
Ознакомьтесь с [сайтом](https://mccteam.github.io/), [README](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config#minecraft-console-client-user-manual) и существующими [обсуждениями](https://github.com/MCCTeam/Minecraft-Console-Client/discussions): Возможно здесь ответ на ваш вопрос. Если нет, откройте [Новое обсуждение](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/new) и задайте свой вопрос. Если вы нашли ошибку, пожалуйста, сообщите об этом в разделе [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues).
|
||||
|
||||
## Discord
|
||||
## Дискорд
|
||||
|
||||
We now have a Discord server, click [here](https://discord.gg/sfBv4TtpC9) to join.
|
||||
Теперь у нас есть Discord сервер, нажмите [здесь](https://discord.gg/sfBv4TtpC9), чтобы присоединиться.
|
||||
|
||||
## Helping Us ❤️
|
||||
## Помощь нам ❤️
|
||||
|
||||
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 :)
|
||||
Мы — небольшое сообщество, поэтому нам нужна помощь в обновлении для новых версий майнкрафт, исправлении ошибок и расширении проекта. Мы всегда ищем мотивированных людей для того чтобы внести свой вклад. Если вам кажется, что это может быть вы, пожалуйста, взгляните на [проблемы](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+is%3Aopen+label%3Awaiting-for%3Acontributor) раздел :)
|
||||
|
||||
## How to contribute 📝
|
||||
## Как принять участие 📝
|
||||
|
||||
If you'd like to contribute to Minecraft Console Client, great, just fork the repository and submit a pull request on the _Master_ branch. To contribute to the website / online documentation see also the [Website repository](https://github.com/MCCTeam/MCCTeam.github.io).
|
||||
Если вы хотите внести свой вклад в консольный клиент Minecraft, просто форкните репозиторий и отправьте запрос на слияние в ветке _мастер_. Чтобы внести свой вклад в развитие сайта / онлайн-документации, см. также [репозиторий веб-сайтов](https://github.com/MCCTeam/MCCTeam.github.io).
|
||||
|
||||
|
||||
|
||||
|
||||
## Translating Minecraft Console Client 🌍
|
||||
## Перевод консольного клиента майнкрафт 🌍
|
||||
|
||||
To improve translations for MCC, please visit: [Crowdin - Minecraft Console Client](https://crwd.in/minecraft-console-client).
|
||||
Чтобы улучшить перевод для MCC, посетите [Crowdin - Консольный клиент майнкрафт](https://crwd.in/minecraft-console-client).
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* `en.ini` : English - English
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `tr.ini` : Türkçe (Türkiye) - Turkish
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
MCC теперь поддерживает следующие языки (алфавитный порядок) :
|
||||
* `de.ini` : Deutsch - Немецкий язык
|
||||
* `en.ini` : English - Английский язык
|
||||
* `fr.ini` : Francais - Французский язык
|
||||
* `ru.ini` : Русский - Русский язык
|
||||
* `tr.ini` : Türkçe - Турецкий язык
|
||||
* `vi.ini` : Tiếng Việt - Вьетнамский язык
|
||||
* `zh-Hans.ini` : 简体中文 - Китайская упрощенная
|
||||
* `zh-Hant.ini` : 繁體中文 - Китайская традиционная
|
||||
|
||||
## Building from the source 🏗️
|
||||
## Сборка из исходного кода 🏗️
|
||||
|
||||
Этот раздел был перемещен на наш новый [сайт документации](https://mccteam.github.io/guide/installation.html#building-from-the-source-code).
|
||||
|
||||
## License ⚖️
|
||||
## Лицензия ⚖️
|
||||
|
||||
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. The main terms of the CDDL-1.0 license are basically the following:
|
||||
Если не указано конкретно, код от команды MCC или участника и доступен в соответствии с CDDL-1.0. В противном случае лицензия и оригинальный автор упоминаются в заголовках исходных файлов. Основными условиями лицензии CDDL-1.0 являются:
|
||||
|
||||
- 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.
|
||||
- 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.
|
||||
- Вы можете использовать лицензионный код полностью или частично в любой программе, которую вы хотите, независимо от лицензии программы в целом (или, скорее, за исключением кода, который вы занимаете). Сама программа может быть открытой или закрытой, свободной или коммерческой.
|
||||
- Однако во всех случаях любые изменения, улучшения, или дополнения к CDDL коду (любой код, на который ссылаются прямые модификации кода CDDL считается добавлением кода CDDL, и так связано этим требованием; напр. модификация функции математики для использования таблицы быстрого поиска делает эту таблицу добавлением к CDDL коду, независимо от того, находится ли он в собственном файле исходного кода) должен быть общедоступным и свободно доступным в исходных кодах, под лицензией CDDL.
|
||||
- В любой программе (исходный код или бинарный код), использующей код CDDL, распознавание должно быть передано источнику (проекту или автору) CDDL кода. Кроме того, модификации CDDL кода (который должен быть распространен в качестве источника) не могут удалять уведомления с указанием происхождения кода.
|
||||
|
||||
More info at http://qstuff.blogspot.fr/2007/04/why-cddl.html Full license at http://opensource.org/licenses/CDDL-1.0
|
||||
Больше информации: http://qstuff.blogspot.fr/2007/04/why-cddl.html Full license at http://opensource.org/licenses/CDDL-1.0
|
||||
|
|
|
|||
32
docs/.vuepress/translations/af.json
Normal file
32
docs/.vuepress/translations/af.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/ar.json
Normal file
32
docs/.vuepress/translations/ar.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/ca.json
Normal file
32
docs/.vuepress/translations/ca.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/cs.json
Normal file
32
docs/.vuepress/translations/cs.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/da.json
Normal file
32
docs/.vuepress/translations/da.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/de.json
Normal file
32
docs/.vuepress/translations/de.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Benutzung",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/el.json
Normal file
32
docs/.vuepress/translations/el.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/es.json
Normal file
32
docs/.vuepress/translations/es.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/fi.json
Normal file
32
docs/.vuepress/translations/fi.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/fr.json
Normal file
32
docs/.vuepress/translations/fr.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Utilisation",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/he.json
Normal file
32
docs/.vuepress/translations/he.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/hu.json
Normal file
32
docs/.vuepress/translations/hu.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/it.json
Normal file
32
docs/.vuepress/translations/it.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/ja.json
Normal file
32
docs/.vuepress/translations/ja.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/ko.json
Normal file
32
docs/.vuepress/translations/ko.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/lv.json
Normal file
32
docs/.vuepress/translations/lv.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/nl.json
Normal file
32
docs/.vuepress/translations/nl.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/no.json
Normal file
32
docs/.vuepress/translations/no.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/pl.json
Normal file
32
docs/.vuepress/translations/pl.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/pt-BR.json
Normal file
32
docs/.vuepress/translations/pt-BR.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/pt.json
Normal file
32
docs/.vuepress/translations/pt.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/ro.json
Normal file
32
docs/.vuepress/translations/ro.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/ru.json
Normal file
32
docs/.vuepress/translations/ru.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Установка",
|
||||
"Usage": "Применение",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/sr-Cyrl.json
Normal file
32
docs/.vuepress/translations/sr-Cyrl.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/sv.json
Normal file
32
docs/.vuepress/translations/sv.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/tr.json
Normal file
32
docs/.vuepress/translations/tr.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Kurulum",
|
||||
"Usage": "Kullanım",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/uk.json
Normal file
32
docs/.vuepress/translations/uk.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
32
docs/.vuepress/translations/vi.json
Normal file
32
docs/.vuepress/translations/vi.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "Usage",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
|
|
@ -1,7 +1,7 @@
|
|||
{
|
||||
"title": "Minecraft命令行客户端",
|
||||
"description": "Minecraft Console Client (MCC) 文档站点",
|
||||
"theme":{
|
||||
"theme": {
|
||||
"selectLanguageName": "简体中文",
|
||||
"selectLanguageText": "选择语言",
|
||||
"selectLanguageAriaLabel": "选择语言",
|
||||
|
|
|
|||
32
docs/.vuepress/translations/zh-Hant.json
Normal file
32
docs/.vuepress/translations/zh-Hant.json
Normal file
|
|
@ -0,0 +1,32 @@
|
|||
{
|
||||
"title": "Minecraft Console Client",
|
||||
"description": "Documentation website for the Minecraft Console Client (MCC)",
|
||||
"theme": {
|
||||
"selectLanguageName": "English",
|
||||
"selectLanguageText": "Languages",
|
||||
"selectLanguageAriaLabel": "Select language",
|
||||
"editLinkText": "Edit this page",
|
||||
"lastUpdatedText": "Last Updated",
|
||||
"contributorsText": "Contributors",
|
||||
"tip": "tip",
|
||||
"warning": "warning",
|
||||
"danger": "danger",
|
||||
"notFound": [
|
||||
"There's nothing here.",
|
||||
"How did we get here?",
|
||||
"That's a Four-Oh-Four.",
|
||||
"Looks like we've got some broken links."
|
||||
],
|
||||
"backToHome": "Take me home",
|
||||
"openInNewWindow": "open in new window",
|
||||
"toggleColorMode": "toggle color mode",
|
||||
"toggleSidebar": "toggle sidebar"
|
||||
},
|
||||
"navbar": {
|
||||
"AboutAndFeatures": "About & Features",
|
||||
"Installation": "Installation",
|
||||
"Usage": "用法",
|
||||
"Configuration": "Configuration",
|
||||
"ChatBots": "ChatBots"
|
||||
}
|
||||
}
|
||||
28
docs/af/README.md
Normal file
28
docs/af/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
home: true
|
||||
heroImage: /images/MCC_logo_with_edge.png
|
||||
tagline: 'Minecraft Console Client (MCC) is a lightweight open-source Minecraft Java client implemented in C#'
|
||||
actions:
|
||||
-
|
||||
text: Installation
|
||||
link: ./guide/installation.md
|
||||
type: primary
|
||||
-
|
||||
text: Learn More →
|
||||
link: ./guide/
|
||||
type: secondary
|
||||
actionText:
|
||||
actionLink:
|
||||
features:
|
||||
-
|
||||
title: Chat
|
||||
details: Chat with other people on the server
|
||||
-
|
||||
title: Automation
|
||||
details: Create bots to do automated tasks
|
||||
-
|
||||
title: Supported Versions
|
||||
details: 1.4 - 1.19.2
|
||||
footer: Made by MCC Team with ❤️
|
||||
---
|
||||
|
||||
163
docs/af/guide/README.md
Normal file
163
docs/af/guide/README.md
Normal file
|
|
@ -0,0 +1,163 @@
|
|||
# Introduction
|
||||
|
||||
- [About](#about)
|
||||
- [Quick Intro (YouTube Videos)](#quick-intro)
|
||||
- [Features](#features)
|
||||
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
||||
- [Getting Help](#getting-help)
|
||||
- [Submitting a bug report or an idea/feature-request](#bugs-ideas-feature-requests)
|
||||
- [Important notes on some features](#notes-on-some-features)
|
||||
- [Credits](#credits)
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source **Minecraft** TUI client for **Java edition** that allows you to connect to any Minecraft Java 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, as well as extensible C# API for creating Bots.
|
||||
|
||||
It was originally made by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
||||
|
||||
## Features
|
||||
|
||||
- Chat
|
||||
|
||||
- Send and receive chat messages
|
||||
- [Log chat history](chat-bots.md#chat-log)
|
||||
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
|
||||
- [Anti AFK](chat-bots.md#anti-afk)
|
||||
- [Auto Relog](chat-bots.md#auto-relog)
|
||||
- [Script Scheduler](chat-bots.md#script-scheduler)
|
||||
- [Remote Control](chat-bots.md#remote-control)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
- [Auto Attack](chat-bots.md#auto-attack)
|
||||
- [Auto Fishing](chat-bots.md#auto-fishing)
|
||||
- [Auto Eat](chat-bots.md#auto-eat)
|
||||
- [Auto Craft](chat-bots.md#auto-craft)
|
||||
- [Mailer Bot](chat-bots.md#mailer)
|
||||
- [Auto Drop](chat-bots.md#auto-drop)
|
||||
- [Replay Mod](chat-bots.md#replay-mod)
|
||||
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
||||
- [Docker Support](installation.md#using-docker)
|
||||
- [Inventory Handling](usage.md#inventory)
|
||||
- [Terrain Traversing](usage.md#move)
|
||||
- Entity Handling
|
||||
|
||||
_NOTE: Some of mentioned features are disabled by default and you will have to turn them on in the configuration file and some may require additional configuration on your part for your specific usage._
|
||||
|
||||
## Why Minecraft Console Client?
|
||||
|
||||
- Easy to use
|
||||
- Helpful community
|
||||
- Open-Source
|
||||
- Fast performance
|
||||
- Cross-Platform
|
||||
- Docker Support
|
||||
- 10 years of continuous development
|
||||
- Active contributors
|
||||
- Widely used
|
||||
|
||||
## Quick Intro
|
||||
|
||||
Don't have time to read through the documentation, we got you, our community has made some simple introduction videos about the **Minecraft Console Client**.
|
||||
|
||||
### The list of the tutorials:
|
||||
|
||||
Installation:
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
Using Commands, Scripts and other features:
|
||||
|
||||
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
||||
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
||||
|
||||
## Getting Help
|
||||
|
||||
MCC has a community that is willing to help, we have a Discussions section in out Git Hub repository.
|
||||
|
||||
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) to access it.
|
||||
|
||||
### Before getting help
|
||||
|
||||
- **Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!**
|
||||
- **Please be kind and patient, respect others as they're the ones using their time to help you**
|
||||
|
||||
## Bugs, Ideas, Feature Requests
|
||||
|
||||
Bug reporting, idea submitting or feature requesting are done in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [Github repository]([here](https://github.com/MCCTeam/Minecraft-Console-Client)).
|
||||
|
||||
Navigate to the Issues section, search for a bug, idea or a feature using the search option here in the documentation and in the `Issues` section on Git Hub before making your own.
|
||||
|
||||
If you haven't found anything similar, go ahead and click on the `New issue` button, then choose what you want to do.
|
||||
|
||||
If you're reporting a bug, please be descriptive as much as possible, try to explain how to re-create the bug, attack screenshots and logs, make sure that you have [`debugmessages`](configuration.me#debugmessages) set to `true` before sending a bug report or taking a screenshot.
|
||||
|
||||
### Before submitting
|
||||
|
||||
- **Please use the search option here or in the `Issues` section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!**
|
||||
- **Please be kind, patient and respect others. Thank you!**
|
||||
|
||||
## Notes on some features
|
||||
|
||||
### Inventory, Terrain and Entity Handling
|
||||
|
||||
Inventory handling is currently not supported in versions: `1.4.6 - 1.9`
|
||||
|
||||
Terrain handling is currently not supported in versions: `1.4.6 - 1.6`
|
||||
|
||||
Entity handling is currently not supported in versions: `1.4.6 - 1.9` (but `1.8` and `1.9` are being worked on, almost at the working state, only `EntityMetadata` packet remains to be fixed)
|
||||
|
||||
There features might not always be implemented in the latest version of the game, since they're often subjected to major changes by Mojang, and we need some time to figure out what has changed and to implement the required changes.
|
||||
|
||||
If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.
|
||||
|
||||
## Credits
|
||||
|
||||
_Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
||||
|
||||
Many features would not have been possible without the help of our talented community:
|
||||
|
||||
**Maintainers**
|
||||
|
||||
ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte
|
||||
|
||||
**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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
||||
|
||||
**Bug Hunters**
|
||||
|
||||
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, 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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
||||
|
||||
**Contributors**
|
||||
|
||||
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
||||
|
||||
**Libraries:**
|
||||
|
||||
Minecraft Console Client also borrows code from the following libraries:
|
||||
|
||||
| Name | Purpose | Author | License |
|
||||
| ----------- | ---------------- | ---------------- | ------- |
|
||||
| Biko | Proxy handling | Benton Stark | MIT |
|
||||
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
||||
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
||||
|
||||
## Disclaimer
|
||||
|
||||
Even if everything should work, we are not responsible for 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 from the source code.
|
||||
|
||||
Also, remember that when you connect to a server with this program, you will appear where you left the last time. This means that **you can die if you log in in an unsafe place on a survival server!** Use the script scheduler bot to send a teleport command after logging in.
|
||||
|
||||
We remind you that **you may get banned** by your server for using this program. Use accordingly with server rules.
|
||||
|
||||
## License
|
||||
|
||||
Minecraft Console Client is a totally free of charge, open source project. The source code is available at [Github Repository](https://github.com/MCCTeam/Minecraft-Console-Client)
|
||||
|
||||
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html) Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|
||||
1921
docs/af/guide/chat-bots.md
Normal file
1921
docs/af/guide/chat-bots.md
Normal file
File diff suppressed because it is too large
Load diff
1185
docs/af/guide/configuration.md
Normal file
1185
docs/af/guide/configuration.md
Normal file
File diff suppressed because it is too large
Load diff
76
docs/af/guide/contibuting.md
Normal file
76
docs/af/guide/contibuting.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# Contributing
|
||||
|
||||
At this moment this page needs to be created.
|
||||
|
||||
For now you can use our article from the [Git Hub repository Wiki](https://github.com/MCCTeam/Minecraft-Console-Client/wiki/Update-console-client-to-new-version) written by [ReinforceZwei](https://github.com/ReinforceZwei).
|
||||
|
||||
## Translations
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* **`en.ini` : English - English**
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
### Add new translation
|
||||
|
||||
1. First you need to get the name of the translated file.
|
||||
* Visit [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) and find the first occurrence of the language you need to translate in the table below.
|
||||
* Use the language code of the row in the table as the name of the translation file.
|
||||
* For example:
|
||||
* `English` -> row `English 0x0009` -> `en` -> `en.ini`
|
||||
* `Chinese (Traditional)` -> row `Chinese (Traditional) 0x7C04` -> `zh-Hant` -> `zh-Hant.ini`
|
||||
|
||||
2. Which system languages are recommended to use this translation?
|
||||
* Still check the table in [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c), one language may have multiple rows.
|
||||
* You will need to indicate which language codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `de.ini` applies to `de`, `de-AT`, `de-BE`, `de-DE`, ...
|
||||
* Translation `zh-Hans.ini` applies to `zh-Hans`, `zh`, `zh-CN`, `zh-SG`.
|
||||
|
||||
3. Which game languages are recommended to use this translation?
|
||||
* Check out the table in [this link](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239), where the `Locale Code` column indicates the language code in minecraft.
|
||||
* You will need to indicate which locale codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `fr.ini` applies to `fr_ca`, `fr_fr`.
|
||||
* Translation `zh-Hans.ini` applies to `zh_cn`.
|
||||
|
||||
4. Add the new translation to the code. (Optional)
|
||||
* **If you are not familiar with programming, you can skip this step and just write the above information in your PR or issue.**
|
||||
* Add the newly created translation file `xx.ini` to the project `/Resources/lang/xx.ini`.
|
||||
* Open `/DefaultConfigResource.resx`.
|
||||
* Click `Add Resources`.
|
||||
* Choose `/Resources/lang/xx.ini`.
|
||||
* Rename the added resource file in `/DefaultConfigResource.resx` to `Translation_xx`.
|
||||
* Open `/Translations.cs`.
|
||||
* Find `public static Tuple<string, string[]> GetTranslationPriority();`
|
||||
* Update the mapping of system language codes to translation files.
|
||||
* Find `public static string[] GetTranslationPriority(string gameLanguage);`
|
||||
* Update the mapping of game locale code to translation files.
|
||||
|
||||
5. Follow the section "Update existing translation".
|
||||
|
||||
### Update existing translation
|
||||
|
||||
1. Visit [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang), download `en.ini` and the language you want to translate(`xx.ini`).
|
||||
|
||||
2. Compare `en.ini` and `xx.ini` and update outdated or non-existent entries in `xx.ini`.
|
||||
|
||||
3. 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.
|
||||
|
||||
### Translate README.md
|
||||
|
||||
1. Get the English version of the README.md from [here](https://raw.githubusercontent.com/MCCTeam/Minecraft-Console-Client/master/README.md).
|
||||
|
||||
2. See `Add new translation -> 1.` for the target language code. Assume it is `xx`.
|
||||
|
||||
3. Complete the translation according to the English README.md and name the translated version as `README-xx.md`.
|
||||
|
||||
4. In the English README, above the "About" section, add the name of the language and a hyperlink to `README-xx.md`.
|
||||
|
||||
## Contributors
|
||||
|
||||
[Check out our contributors on Github](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors).
|
||||
170
docs/af/guide/creating-bots.md
Normal file
170
docs/af/guide/creating-bots.md
Normal file
|
|
@ -0,0 +1,170 @@
|
|||
# Creating Chat Bots
|
||||
|
||||
- [Notes](#notes)
|
||||
- [Requirements](#requirements)
|
||||
- [Quick Introduction](#quick-introduction)
|
||||
- [Examples](#examples)
|
||||
- [C# API](#c#-api)
|
||||
|
||||
## Notes
|
||||
|
||||
> **ℹ️ NOTE: For now this page contains only the bare basics of the Chat Bot API, enough of details to teach you how to make basic Chat Bots. For more details you need to take a look at the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) and [Examples](#examples). This page will be improved in the future.**
|
||||
|
||||
**Minecraft Console Client** has a rich C# API which allows you to create Chat Bots (effectively plugins) which can help you create complex automations which normal scripts may not be able to do.
|
||||
|
||||
## Requirements
|
||||
|
||||
- A basic knowledge of C# programming language
|
||||
- A text editor
|
||||
|
||||
If you're not familiar with the C# programming language, we suggest taking a look at the following resources:
|
||||
|
||||
Crash courses:
|
||||
|
||||
- [C# Crash Course playlist by Teddy Smit](https://www.youtube.com/watch?v=67oWw9TanOk&list=PL82C6-O4XrHfoN_Y4MwGvJz5BntiL0z0D)
|
||||
|
||||
More in-depth:
|
||||
|
||||
- [Learn C# Youtube Playlist by Microsoft](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oVxKLQCHpiUWun7vlJJvUiN)
|
||||
- [Getting started with C# (An index of tutorials and the documentation) by Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/)
|
||||
|
||||
## Quick Introduction
|
||||
|
||||
This introduction assumes that you have the basic knowledge of C#.
|
||||
|
||||
> **ℹ️ NOTE: Here we will use terms Chat Bot and Script interchangeably**
|
||||
|
||||
Create a new empty file and name it `ExampleChatBot.cs` in the same folder where you have your MCC installed.
|
||||
|
||||
Paste the following example code:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
|
||||
// The code and comments above are defining a "Script Metadata" section
|
||||
|
||||
// Every single chat bot (script) must be a class which extends the ChatBot class.
|
||||
// Your class must be instantiates in the "Script Metadata" section and passed to MCC.LoadBot function.
|
||||
class ExampleChatBot : ChatBot
|
||||
{
|
||||
// This method will be called when the script has been initialized for the first time, it's called only once
|
||||
// Here you can initialize variables, eg. Dictionaries. etc...
|
||||
public override void Initialize()
|
||||
{
|
||||
LogToConsole("An example Chat Bot has been initialized!");
|
||||
}
|
||||
|
||||
// This is a function that will be run when we get a chat message from a server
|
||||
// In this example it just detects the type of the message and prints it out
|
||||
public override void GetText(string text)
|
||||
{
|
||||
string message = "";
|
||||
string username = "";
|
||||
text = GetVerbatim(text);
|
||||
|
||||
if (IsPrivateMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has sent you a private message: " + message);
|
||||
}
|
||||
else if (IsChatMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has said: " + message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Start MCC, connect to a server and run the following internal command: `/script ExampleChatBot.cs`.
|
||||
|
||||
If you did everything right you should see: `[Example Chat Bot] An example Chat Bot has been initialised!` message appear in your console log.
|
||||
|
||||
### Structure of Chat Bots
|
||||
|
||||
Chat Bot (Script) structure is the following:
|
||||
|
||||
```
|
||||
<script metadata>
|
||||
<chat bot class>
|
||||
```
|
||||
|
||||
**Script Metadata** is a section with a custom format that mixes in C# with our format using comments. Every single Chat Bot (Script) must have this section at the beginning in order to work.
|
||||
|
||||
### Script Metadata Format
|
||||
|
||||
`//MCCScript 1.0` marks the beginning of the **Script Metadata** section, this must always be on the first line or the Chat Bot (Script) will not load and will throw an error.
|
||||
|
||||
`//MCCScript Extensions` marks the end of the **Script Metadata** section, this must be defined before a Chat Bot (Script) class.
|
||||
|
||||
In order for your Chat Bot (Script) to properly load in-between the `//MCCScript 1.0` and the `//MCCScript Extensions` lines you must instantiate your Chat Bot (Script) class and pass it to the `MCC.LoadBot` function.
|
||||
|
||||
Example code:
|
||||
|
||||
```
|
||||
MCC.LoadBot(new YourChatBotClassNameHere());
|
||||
```
|
||||
|
||||
**Script Metadata** section allows for including C# packages and libraries with: `//using <namespace>` and `/dll <dll name>`.
|
||||
|
||||
> **ℹ️ NOTE: Avoid adding whitespace between `//` and keywords**
|
||||
|
||||
By the default the following packages are loaded:
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Text.RegularExpressions;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.IO;
|
||||
using System.Net;
|
||||
using System.Threading;
|
||||
using MinecraftClient;
|
||||
using MinecraftClient.Mapping;
|
||||
using MinecraftClient.Inventory;
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```csharp
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
```
|
||||
|
||||
Full Example:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
```
|
||||
|
||||
### Chat Bot Class
|
||||
|
||||
After the end of the **Script Metadata** section, you basically can define any number of classes you like, the only limitation is that the main class of your Chat Bot (Script) must extend `ChatBot` class.
|
||||
|
||||
There are no required methods, everything is optional.
|
||||
|
||||
When the Chat Bot (Script) has been initialized for the first time the `Initialize` method will be called. In it you can initialize variables, eg. Dictionaries, etc..
|
||||
|
||||
> **ℹ️ NOTE: For allocating resources like a database connection, we recommend allocating them in `AfterGameJoined` and freeing them in `OnDisconnect`**.
|
||||
|
||||
## Examples
|
||||
|
||||
You can find a lot of examples in our Git Hub Repository at [ChatBots](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/ChatBots) and [config](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config).
|
||||
|
||||
## C# API
|
||||
|
||||
As of the time of writing, the C# API has been changed in forks that are yet to be merged, so for now you can use the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) for reference.
|
||||
|
||||
Each method is well documented with standard C# documentation comments.
|
||||
|
||||
In the future we will make a script to auto-generate this section based on the documentation in the code.
|
||||
931
docs/af/guide/installation.md
Normal file
931
docs/af/guide/installation.md
Normal file
|
|
@ -0,0 +1,931 @@
|
|||
# Installation
|
||||
|
||||
- [YouTube Tutorials](#youtube-tutorials)
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker)
|
||||
- [Run on Android](#run-on-android)
|
||||
- [Run MCC 24/7 on a VPS](#run-on-a-vps)
|
||||
|
||||
## YouTube Tutorials
|
||||
|
||||
If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
## Download a compiled binary
|
||||
|
||||
In order to run **Minecraft Console Client** you need [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download)
|
||||
|
||||
> **⚠️ IMPORTANT: If you already have .NET, but an older version than `6.0`, please update to `6.0` since MCC might not work as expected or at all.**
|
||||
|
||||
#### How to install .NET on your platform
|
||||
|
||||
- [Install .NET on Windows](https://docs.microsoft.com/en-us/dotnet/core/install/windows)
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Download
|
||||
|
||||
You can download a compiled binary file of the latest build from our Releases section on Git Hub: [Download](https://github.com/MCCTeam/Minecraft-Console-Client/releases)
|
||||
|
||||
## Building from the source code
|
||||
|
||||
### Windows
|
||||
|
||||
Requirements:
|
||||
|
||||
- [Git](https://www.git-scm.com/)
|
||||
- [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
Install [Git](https://www.git-scm.com/)
|
||||
|
||||
1. Make a new folder where you want to keep the source code
|
||||
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
|
||||
3. Click on `Git Bash Here` in the context menu
|
||||
4. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
|
||||
6. Open up the new cloned folder
|
||||
|
||||
#### Building using the Visual Studio
|
||||
|
||||
1. Open up the `MinecraftClient.sln` via Visual Studio
|
||||
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
3. Click on `Properties`
|
||||
4. Open up the `Build` tab and select configuration `Release`
|
||||
5. Press `CTRL + S` and close the file
|
||||
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
7. Click `Build`
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
#### Building using .NET manually without Visual Studio
|
||||
|
||||
1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
|
||||
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
|
||||
3. Run the following command to build the project:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r win-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
### Linux, macOS
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
|
||||
- Linux:
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**
|
||||
|
||||
- [Install Git on macOS](https://git-scm.com/download/mac)
|
||||
|
||||
- .NET SDK 6.0 or new-er
|
||||
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
1. Open up a terminal emulator and navigate to the folder where you will store the MCC
|
||||
2. Recursively clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)
|
||||
4. Run the following command to build the project:
|
||||
|
||||
- On Linux:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r linux-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux that is either ARM, 32-bit, Rhel based, Using Musl, or Tirzen, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace the `'-r linux-64` with an appropriate `-r <your RID>` (Example for arm: `-r linux-arm64`)**
|
||||
|
||||
- On macOS:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r osx-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're not using MAC with Intel, find an appropriate RID for your ARM processor, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) and replace the `'-r osx-64` with an appropriate `-r <your RID>` (Example for arm: `-r osx.12-arm64`)**
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient` will be in:
|
||||
|
||||
- Linux: `MinecraftClient/bin/Release/net6.0/linux-x64/publish/`
|
||||
- macOS: `MinecraftClient/bin/Release/net6.0/osx-x64/publish/`
|
||||
|
||||
## Using Docker
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
- Docker
|
||||
|
||||
> **ℹ️ NOTE: This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**
|
||||
|
||||
> **⚠️ WARNING: Pay attention at warnings, Docker currently works, but you must start the containers in the interactive mode or MCC will crash, we're working on solving this.**
|
||||
|
||||
1. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
2. Navigate to `Minecraft-Console-Client/Docker`
|
||||
3. Build the image using the following command
|
||||
|
||||
```bash
|
||||
docker build -t minecraft-console-client:latest .
|
||||
```
|
||||
|
||||
**Start the container using Docker:**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: There is a bug with the ConsoleInteractive which causes a crash when a container is started in a headless mode, so you need to use the interactive mode. Do not restart containers in a classic way, stop then and start them with interactive mode (this command), after that simply detach with `CTRL + P` and then `CTRL + Q`.**
|
||||
|
||||
```bash
|
||||
# You could also ignore the -v parameter if you dont want to mount the volume that is up to you. If you don't it's harder to edit the .ini file if thats something you want to do
|
||||
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
|
||||
```
|
||||
|
||||
Now you could login and the Client is running. To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`. To reattach use the `docker attach` command.
|
||||
|
||||
**Start the container using docker-compose:**
|
||||
|
||||
By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.
|
||||
|
||||
If you don't want to map a volume, you have to comment out or delete the entire volumes section:
|
||||
|
||||
```yml
|
||||
#volumes:
|
||||
#- './data:/opt/data'
|
||||
```
|
||||
|
||||
Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:
|
||||
|
||||
```bash
|
||||
docker-compose run MCC
|
||||
```
|
||||
|
||||
Remember to remove the container after usage:
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
If you use the INI file and entered your data (username, password, server) there, you can start your container using
|
||||
|
||||
```bash
|
||||
docker-compose up
|
||||
docker-compose up -d #for deamonized running in the background
|
||||
```
|
||||
|
||||
Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`. As above, you can stop and remove the container using
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Run on Android
|
||||
|
||||
It is possible to run the Minecraft Console Client on Android through Termux and Ubuntu 22.04 in it, however it requires a manual setup with a lot of commands, be careful no to skip any steps. Note that this might take anywhere from 10 to 20 minutes or more to do depending on your technical knowledge level, Internet speed and CPU speed.
|
||||
|
||||
> **ℹ️ NOTE: This section is going to get a bit technical, I'll try my best to make everything as simple as possible. If you are having trouble following along or if you encounter any issues, feel free to open up a discussion on our Github repository page.**
|
||||
|
||||
> **ℹ️ NOTE: You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**
|
||||
|
||||
> **ℹ️ NOTE: Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**
|
||||
|
||||
### Installation
|
||||
|
||||
#### Termux
|
||||
|
||||
> **⚠️ IMPORTANT: The Play Store version of Termux is outdated and not supported, do not use it, use the the [Github one](https://github.com/termux/termux-app/releases/latest/).**
|
||||
|
||||
Go to [the Termux Github latest release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it and run it.
|
||||
|
||||
> **ℹ️ NOTE: If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!**
|
||||
|
||||
#### Installing Ubuntu 22.04
|
||||
|
||||
At this stage, you have 2 options:
|
||||
|
||||
1. Following this textual tutorial
|
||||
2. Watching a [Youtube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM)
|
||||
|
||||
> **ℹ️ NOTE: If you decide to watch the Youtube tutorial, watch only up to `1:58`, the steps after are not needed and might just confuse you.**
|
||||
|
||||
In order to install Ubuntu 22.04 in Termux you require `wget` and `proot`, we're going to install them in the next step.
|
||||
|
||||
Once you have Termux installed open it up and run the following command one after other (in order):
|
||||
|
||||
1. `pkg update`
|
||||
2. `pkg upgrade`
|
||||
3. `pkg install proot wget`
|
||||
|
||||
> **ℹ️ NOTE: If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter**
|
||||
|
||||
Then you need to download an installation script using the following command:
|
||||
|
||||
```bash
|
||||
wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh
|
||||
```
|
||||
|
||||
Once the script has downloaded, run it with:
|
||||
|
||||
```bash
|
||||
bash ubuntu.sh
|
||||
```
|
||||
|
||||
Then you will be asked a question, enter `Y` and press `Enter`. Once the installation is complete, you can start Ubuntu with:
|
||||
|
||||
```bash
|
||||
./startubuntu.sh
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command**
|
||||
|
||||
#### Installing .NET on ARM
|
||||
|
||||
Since there are issues installing .NET 6.0 via the APT package manager at the time of writing, we will have to install it manually.
|
||||
|
||||
First we need to update the APT package manager repositories and install dependencies.
|
||||
|
||||
To update the APT repositories, run the following command:
|
||||
|
||||
```bash
|
||||
apt update -y && apt upgrade -y
|
||||
```
|
||||
|
||||
After you did it, we need to install dependencies for .NET, with the following command:
|
||||
|
||||
```bash
|
||||
apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y
|
||||
```
|
||||
|
||||
After you have installed dependencies, it's time to install .NET, you either can follow this tutorial or the [Microsoft one](https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install).
|
||||
|
||||
Navigate to your `/root` home directory with the following command:
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
```
|
||||
|
||||
First you need to download .NET 6.0, you can do it with the following command:
|
||||
|
||||
```bash
|
||||
wget https://download.visualstudio.microsoft.com/download/pr/901f7928-5479-4d32-a9e5-ba66162ca0e4/d00b935ec4dc79a27f5bde00712ed3d7/dotnet-sdk-6.0.400-linux-arm64.tar.gz
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you have 64 bit version of ARM processor, if you happen to have a 32-bit version replace the link in the command above with [this one](https://download.visualstudio.microsoft.com/download/pr/cf567026-a29a-41aa-bc3a-e4e1ad0df480/0925d411e8e09e31ba7a39a3eb0e29af/aspnetcore-runtime-6.0.8-linux-arm.tar.gz)**.
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you're following along and using Ubuntu 22.04, if you're using a different distro, like Alpine, go to [here](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) and copy an appropriate link for your distro.**
|
||||
|
||||
Once the file has been downloaded, you need to run the following commands in order:
|
||||
|
||||
1. `DOTNET_FILE=dotnet-sdk-6.0.400-linux-arm64.tar.gz`
|
||||
|
||||
> **⚠️ IMPORTANT: If you're using a different download link, update the file name in this command to match your version.**
|
||||
|
||||
2. `export DOTNET_ROOT=/root/.dotnet`
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"`
|
||||
4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools`
|
||||
|
||||
Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located.
|
||||
|
||||
> **⚠️ IMPORTANT: You will need a basic knowledge of Nano text editor, if you do not know how to use it, watch this [Youtube video tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A)**
|
||||
|
||||
To enable this, we need to edit our `/root/.bashrc` file with the following command:
|
||||
|
||||
```bash
|
||||
nano /root/.bashrc
|
||||
```
|
||||
|
||||
Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text:
|
||||
|
||||
```bash
|
||||
export DOTNET_ROOT=/root/.dotnet/
|
||||
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
|
||||
```
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter.
|
||||
|
||||
Veryfy that .NET was installed correctly by running:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get a help page:
|
||||
|
||||
```bash
|
||||
root@localhost:~# dotnet
|
||||
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
#### Installing MCC
|
||||
|
||||
Finally, we can install MCC.
|
||||
|
||||
> **⚠️ IMPORTANT: If you have a 32 ARM processor, you need to build the MCC yourself, take a look at the [Building From Source](#building-from-the-source-code) section. Also make sure to be using the appropriate `-r` parameter value for your architecture.**
|
||||
|
||||
Let's make a folder where the MCC will be stored with the following command:
|
||||
|
||||
```bash
|
||||
mkdir MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Then enter it the newly created folder:
|
||||
|
||||
```bash
|
||||
cd MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Download the MCC with the following command:
|
||||
|
||||
```bash
|
||||
wget https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest/download/MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
Unzip it with the following command:
|
||||
|
||||
```bash
|
||||
unzip MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
You can remove the zip archive now, we do not need it anymore, with:
|
||||
|
||||
```bash
|
||||
rm MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
And finally run it with:
|
||||
|
||||
```
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
#### After installation
|
||||
|
||||
When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh`
|
||||
|
||||
Then you can start the MCC again with `./MinecraftClient`
|
||||
|
||||
To stop MCC from running you can press `CTRL + C`
|
||||
|
||||
To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use, if you have followed the installation steps above, you should be familiar with it, if not, check out [this tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).
|
||||
|
||||
For downloading files, you can use the `wget` file we have installed, simply run: `wget your_link_here` (you have examples above, and a video tutorial down bellow).
|
||||
|
||||
Also, here are some linux tutorials for people who are new to it:
|
||||
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
## Run on a VPS
|
||||
|
||||
> **ℹ️ NOTE: This is a new section, if you find a mistake, please report it by opening an Issue in our [Github repository](https://github.com/MCCTeam/Minecraft-Console-Client). Thank you!**
|
||||
|
||||
The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.
|
||||
|
||||
- [What is a VPS?](#what-is-a-vps)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Where to get a VPS](#where-to-get-a-vps)
|
||||
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
|
||||
- [Initial VPS setup](#initial-vps-setup)
|
||||
- [Creating a new user account](#creating-a-new-user)
|
||||
- [Installing .NET Core 6](#installing-net-core-6)
|
||||
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)
|
||||
|
||||
### What is a VPS?
|
||||
|
||||
VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).
|
||||
|
||||
You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.
|
||||
|
||||
Here is a [Youtube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you're interested.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. Gitbash (if you're on Windows)
|
||||
|
||||
Download and install [Gitbash](https://git-scm.com/downloads).
|
||||
|
||||
> **ℹ️ NOTE: Make sure to allow the installation to add it to the context menu**
|
||||
|
||||
2. `ssh` and `ssh-keygen` commands (On Windows they're available with Gitbash, on macOs and Linux they should be available by default, it not, search on how to install them)
|
||||
|
||||
3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.
|
||||
|
||||
If you already know this, feel free to skip.
|
||||
|
||||
if you get stuck, watch those tutorials.
|
||||
|
||||
If you're new to this, you can learn about it here:
|
||||
|
||||
- [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
### Where to get a VPS
|
||||
|
||||
You have 2 options:
|
||||
|
||||
- [Buying a VPS](#buying-a-vps)
|
||||
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)
|
||||
|
||||
#### Buying a VPS
|
||||
|
||||
If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.
|
||||
|
||||
**What hardware requirements I need for running the MCC?**
|
||||
|
||||
The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.
|
||||
|
||||
**Where to buy a VPS?**
|
||||
|
||||
> **⚠️ VERY IMPORTANT: In this tutorial we will be using `Ubuntu 22.04`, make sure to select it as the OS when buying a VPS.**
|
||||
|
||||
Some of the reliable and cheap hosting providers (sorted for price/performance):
|
||||
|
||||
- [E-Trail](https://e-trail.net/vps)
|
||||
|
||||
**Minimum price**: `2.50 EUR / month`
|
||||
|
||||
> **ℹ️ NOTE: Does not have Ubuntu 22.04 in the dropdown menu when ordering, you will have to re-install later or ask support to do it.**
|
||||
|
||||
- [OVH Cloud](https://www.ovhcloud.com/de/vps/)
|
||||
|
||||
**Minimum price**: `3.57 EUR / month`
|
||||
|
||||
- [Hetzner Cloud](https://www.hetzner.com/cloud)
|
||||
|
||||
**Minimum price**: `4.51 EUR / month`
|
||||
|
||||
- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)
|
||||
|
||||
**Minimum price**: `4 EUR / month`
|
||||
|
||||
- [Contabo](https://contabo.com/en/vps/)
|
||||
|
||||
**Minimum price**: `7 EUR / month`
|
||||
|
||||
**More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**
|
||||
|
||||
You also may want to search for better deals.
|
||||
|
||||
#### AWS EC2 VPS
|
||||
|
||||
> **⚠️ VERY IMPORTANT: This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**
|
||||
|
||||
> **⚠️ WARNING: Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**
|
||||
|
||||
> **⚠️ WARNING: Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**
|
||||
|
||||
> **ℹ️ NOTE: If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**
|
||||
|
||||
Register on AWS and enter all of your billing info and a phone number. Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).
|
||||
|
||||
### Initial Amazon VPS setup
|
||||
|
||||
> **ℹ️ NOTE: Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**
|
||||
|
||||
When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`
|
||||
|
||||
> **ℹ️ NOTE: Make sure to select the region closest to you for the minimal latency**
|
||||
|
||||
Click on the **Launch instance** button.
|
||||
|
||||
Fill out the `Name` field with a name of your preference.
|
||||
|
||||
|
||||
|
||||
For the **Application and OS images** select `Ubuntu Server 22.04 LTS (HVM), SSD Volume Type`.
|
||||
|
||||
> **⚠️ VERY IMPORTANT: Make sure that it has `Free tier eligible` next to it.**
|
||||
|
||||
|
||||
|
||||
For the **Instance type** select `t2.micro`.
|
||||
|
||||
For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.
|
||||
|
||||
> **⚠️ EXTREMELY IMPORTANT: Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**
|
||||
|
||||
|
||||
|
||||
For the **Network settings** check the following checkboxes on:
|
||||
|
||||
- `Allow SSH traffic from` (Anywhere)
|
||||
- `Allow HTTPs traffic from the internet`
|
||||
- `Allow HTTP traffic from the internet`
|
||||
|
||||
> **ℹ️ NOTE: The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**
|
||||
|
||||
|
||||
|
||||
For the **Storage** enter `30`.
|
||||
|
||||
|
||||
|
||||
Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.
|
||||
|
||||
Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.
|
||||
|
||||
You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
In order to login with SSH, you are going to use the following command:
|
||||
|
||||
```bash
|
||||
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<` and `>` are not typed, that is just a notation for a placeholder!**
|
||||
|
||||
> **ℹ️ NOTE: `ubuntu` is a default root account username for Ubuntu on AWS!**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
|
||||
```
|
||||
|
||||
If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.
|
||||
|
||||
Now you can continue to [Creating a new user](#creating-a-new-user)
|
||||
|
||||
### Initial VPS setup
|
||||
|
||||
> **ℹ️ NOTE: This section if for those who do not use AWS, if you use AWS skip it**
|
||||
|
||||
When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.
|
||||
|
||||
Other option is that you will get your login info in the email once the setup is done.
|
||||
|
||||
Once you have the root login account info, you need [Gitbash](https://git-scm.com/downloads) on Windows and `ssh` if you're on macOS or Linux (if you do not have it by some chance, search on how to install it, it is simple).
|
||||
|
||||
If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:
|
||||
|
||||
```bash
|
||||
ssh <username>@<ip>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh root@142.26.73.14
|
||||
```
|
||||
|
||||
Example with port:
|
||||
|
||||
```bash
|
||||
ssh -p 2233 root@142.26.73.14
|
||||
```
|
||||
|
||||
Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.
|
||||
|
||||
### Creating a new user
|
||||
|
||||
Once you've logged in to your VPS you need to create a new user and give it SSH access.
|
||||
|
||||
In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.
|
||||
|
||||
> **ℹ️ NOTE: You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**
|
||||
|
||||
To create a new user named `mcc` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo useradd mcc -m
|
||||
```
|
||||
|
||||
Now we need to give it a password, execute the following command, type the password and confirm it:
|
||||
|
||||
```bash
|
||||
sudo passwd mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: When you're typing a password it will not be displayed on the screen, but you're typing it for real.**
|
||||
|
||||
> **ℹ️ NOTE: Make sure you have a strong password!**
|
||||
|
||||
Now we need to give our user account the admin permissions:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG sudo mcc
|
||||
```
|
||||
|
||||
Now we are going to set it's shell to bash:
|
||||
|
||||
```bash
|
||||
sudo chsh mcc -s /bin/bash
|
||||
```
|
||||
|
||||
Now we need to log in as the `mcc` user:
|
||||
|
||||
```bash
|
||||
su mcc
|
||||
```
|
||||
|
||||
Fill in your password when asked.
|
||||
|
||||
Navigate to the `mcc` user home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Make a new `.ssh` directory:
|
||||
|
||||
```bash
|
||||
mkdir .ssh
|
||||
```
|
||||
|
||||
Enter it with:
|
||||
|
||||
```bash
|
||||
cd .ssh
|
||||
```
|
||||
|
||||
Make a new empty file named `authorized_keys`:
|
||||
|
||||
```bash
|
||||
touch authorized_keys
|
||||
```
|
||||
|
||||
Do no close the Git bash/Terminal emulator. On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account. Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
Type the following command:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t RSA -b 4096
|
||||
```
|
||||
|
||||
Enter the name of the key file to be: `MCC_Key`, press Enter.
|
||||
|
||||
When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.
|
||||
|
||||
This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.
|
||||
|
||||
Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.
|
||||
|
||||
Return to the Git Bash/Terminal emulator and execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install nano -y
|
||||
```
|
||||
|
||||
This will install the Nano editor on your VPS.
|
||||
|
||||
Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.
|
||||
|
||||
Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:
|
||||
|
||||
```bash
|
||||
pwd
|
||||
```
|
||||
|
||||
If it does not print `/home/mcc/.ssh`, navigate to it with:
|
||||
|
||||
```bash
|
||||
cd /home/mcc/.ssh
|
||||
```
|
||||
|
||||
Now you need to open the `authorized_keys` file with the nano editor:
|
||||
|
||||
```bash
|
||||
nano authorized_keys
|
||||
```
|
||||
|
||||
Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.
|
||||
|
||||
Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.
|
||||
|
||||
Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:
|
||||
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
```
|
||||
|
||||
Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.
|
||||
|
||||
Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.
|
||||
|
||||
Additionally for better security you can do the following:
|
||||
|
||||
- Set `PermitRootLogin` to `yes`
|
||||
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
|
||||
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)
|
||||
|
||||
Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.
|
||||
|
||||
Now we need to restart the SSHD service with:
|
||||
|
||||
```bash
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
Let's check if everything is working correctly:
|
||||
|
||||
```bash
|
||||
sudo systemctl status sshd
|
||||
```
|
||||
|
||||
If everything has been configured as it should be you should see `active (running)` as a status of the service. If not, open the config file again and check for mistakes.
|
||||
|
||||
Press `q` to exit the log mode.
|
||||
|
||||
Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.
|
||||
|
||||
Now we can login to the user with our private `MCC_Key` file.
|
||||
|
||||
Command:
|
||||
|
||||
```bash
|
||||
ssh -i <path to the MCC_Key private key> mcc@<ip here>
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i MCC_Key mcc@3.71.108.69
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**
|
||||
|
||||
If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.
|
||||
|
||||
You can do `whoami` to see your username.
|
||||
|
||||
Now you can install .NET Core 6 and MCC.
|
||||
|
||||
### Installing .NET Core 6
|
||||
|
||||
> **ℹ️ NOTE: If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**
|
||||
|
||||
> **⚠️ WARNING: With newer versions of .NET Core 6 on Ubuntu 22.04 you might get the following error: `A fatal error occurred, the folder [/usr/share/dotnet/host/fxr] does not contain any version-numbered child folders`, if you get it, use [this solution](https://github.com/dotnet/sdk/issues/27082#issuecomment-1211143446)**
|
||||
|
||||
Log in as the user you've created.
|
||||
|
||||
Update the system packages and package manager repositories:
|
||||
|
||||
```bash
|
||||
sudo apt update -y && sudo apt upgrade -y
|
||||
```
|
||||
|
||||
Install `wget`:
|
||||
|
||||
```bash
|
||||
sudo apt install wget -y
|
||||
```
|
||||
|
||||
Go to your home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Download the Microsoft repository file:
|
||||
|
||||
```bash
|
||||
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Add Microsoft repositories to the package manager:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Remove the file, we do not need it anymore:
|
||||
|
||||
```bash
|
||||
rm packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Finally, install .NET Core 6:
|
||||
|
||||
```bash
|
||||
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-6.0
|
||||
```
|
||||
|
||||
Run the following command to check if everything was installed correctly:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get:
|
||||
|
||||
```
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
If you do not get this output and the installation was not successful, [try other methods](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu#2204).
|
||||
|
||||
If it was successful, you can now install the MCC.
|
||||
|
||||
### Installing MCC on a VPS
|
||||
|
||||
Now that you have .NET Core 6.0 and a user account, you should install the `screen` utility, you will need this in order to keep the MCC running once you close down the SSH session (if you do not have it, the MCC will just stop working once you disconnect). You can look at the `screen` like a window, except it's in a terminal, it lets you have multiple "windows" open at the same time.
|
||||
|
||||
> **ℹ️ NOTE: There is also a Docker method, if you're using Docker, you do not need the `screen` program.**
|
||||
|
||||
You also can learn about the screen command from [this Youtube tutorial](https://youtu.be/_ZJiEX4rmN4).
|
||||
|
||||
To install the `screen` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install screen -y
|
||||
```
|
||||
|
||||
Now you can install the MCC:
|
||||
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)
|
||||
|
||||
How to use the `screen` command?
|
||||
|
||||
> **⚠️ WARNING: If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**
|
||||
|
||||
To start a screen, type:
|
||||
|
||||
```bash
|
||||
screen -S mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**
|
||||
|
||||
> **ℹ️ NOTE: You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**
|
||||
|
||||
Now you will be in the screen, now you can start the MCC and detach from the screen.
|
||||
|
||||
To detach from the screen press `CTRL + A + D`.
|
||||
|
||||
To re-attach/return to the screen, execute the following command:
|
||||
|
||||
```bash
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:
|
||||
|
||||
```bash
|
||||
screen -d mcc
|
||||
```
|
||||
|
||||
To list out screens you can use:
|
||||
|
||||
```bash
|
||||
screen -ls
|
||||
```
|
||||
|
||||
To stop the MCC, you can hit `CTRL + D` (hit it few times).
|
||||
919
docs/af/guide/usage.md
Normal file
919
docs/af/guide/usage.md
Normal file
|
|
@ -0,0 +1,919 @@
|
|||
# Usage
|
||||
|
||||
How to run the program:
|
||||
|
||||
- [Running on Windows](#windows)
|
||||
- [Running on Linux, macOS](#linux-macos)
|
||||
- [Running using Docker](#docker)
|
||||
|
||||
Using the command line parameters:
|
||||
|
||||
- [Examples](#quick-usage-of-mcc-with-examples)
|
||||
- [Command line parameters](#command-line-parameters)
|
||||
- [Internal commands](#internal-commands)
|
||||
|
||||
## Windows
|
||||
|
||||
Simply run `MinecraftClient.exe`
|
||||
|
||||
> **ℹ️ NOTE: On Windows it's best using [Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/install) for the best experience and looks. Some features like emojis in the [`/chunk`](#chunk) command do not work in CMD or Powershell 5**
|
||||
|
||||
## Linux, macOS
|
||||
|
||||
To run the client you need to type the following command in your terminal emulator:
|
||||
|
||||
```bash
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
If you want to keep it running in the background you can use `screen` (Linux only) Example:
|
||||
|
||||
```bash
|
||||
# Start the screen
|
||||
screen -S mcc
|
||||
|
||||
# Run it
|
||||
./MinecraftClient
|
||||
|
||||
# Detach from the screen by pressing CTRL + A + D
|
||||
|
||||
# Re-attach if you want to have accces again
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
_Learn more on how to use the screen command: [YouTube](https://www.youtube.com/watch?v=_ZJiEX4rmN4)_
|
||||
|
||||
## Docker
|
||||
|
||||
See [Run using Docker](./guide/installation.md#using-docker)
|
||||
|
||||
## Command-line usage
|
||||
|
||||
**Minecraft Console Client** has a plethora of useful command line parameters, here you can learn about them.
|
||||
|
||||
### For people not familiar with the command line
|
||||
|
||||
For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.
|
||||
|
||||
In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.
|
||||
|
||||
Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:
|
||||
|
||||
- `someparameter`
|
||||
- `-some-parameter`
|
||||
- `--some-other-parameter`
|
||||
- `--some-setting="some value"`
|
||||
- `-a=5`
|
||||
|
||||
Parameters with a single dash (`-`) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (`--`) are being used for parameters with a longer/full name.
|
||||
|
||||
When you are reading examples, you will often see something like this: `<something here>`, this means that this is a place holder and it should be changed with some value, excluding the `<` and the `>`.
|
||||
|
||||
For example `<username>` you need to change to an username of your liking, example: `notch` (`<` and `>` should not be included).
|
||||
|
||||
`[` and `]` mean that a parameter is an optional one.
|
||||
|
||||
They also can hold some values, example from the MCC:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
```
|
||||
|
||||
When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes (`"`), example: `--some-parameter="some text here with spaces in it"`
|
||||
|
||||
Here is an example for using a `--help` command line parameter for MCC that will print out a page on how to use MCC from the command line:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
```
|
||||
|
||||
### Quick usage of MCC with examples
|
||||
|
||||
> **ℹ️ NOTE: On Linux and macOS, you need to type: `./MinecraftClient` instead of `MinecraftClient.exe`**
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
MinecraftClient.exe <username> <password> <server>
|
||||
MinecraftClient.exe <username> <password> <server> "/mycommand"
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
MinecraftClient.exe --section.setting=value [--other settings]
|
||||
MinecraftClient.exe <settings-file.ini> [--other settings]
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
|
||||
MinecraftClient.exe notch password123 mc.someserver.com:25565
|
||||
|
||||
# Overriding a setting from MinecraftClient.ini using a command line parameter
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
|
||||
# Providing a custom settings ini file and overriding a language to Chinese
|
||||
MinecraftClient.exe CustomSettingsFile.ini --language=zh
|
||||
```
|
||||
|
||||
### Rules of using the command line parameters
|
||||
|
||||
You can mix and match arguments by following theses rules:
|
||||
|
||||
- First positional argument may be either the login or a settings file
|
||||
- Other positional arguments are read in order: login, password, server, command
|
||||
- Arguments starting with `--` can be in any order and position
|
||||
|
||||
Examples and further explanations:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server>
|
||||
```
|
||||
|
||||
- This will automatically connect you to the chosen server.
|
||||
- You may omit password and/or server to specify e.g. only the login
|
||||
- To specify a server but ask password interactively, use `""` as password.
|
||||
- To specify offline mode with no password, use `-` as password.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server> "/mycommand"
|
||||
```
|
||||
|
||||
- This will automatically send `/mycommand` to the server and close.
|
||||
- To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini>
|
||||
```
|
||||
|
||||
- This will load the specified configuration file
|
||||
- If the file contains login / password / server ip, it will automatically connect.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
```
|
||||
|
||||
- Specify settings on the command-line, see possible value in the configuration file
|
||||
- Use `--section.setting=value` for settings outside the `[Main]` section
|
||||
- Example: `--antiafk.enabled=true` for enabling the `AntiAFK` bot
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]
|
||||
```
|
||||
|
||||
- Load the specified configuration file and override some settings from the file
|
||||
|
||||
## Internal Commands
|
||||
|
||||
These commands can be performed from the chat prompt, scripts or remote control.
|
||||
|
||||
From chat prompt, commands must by default be prepended with a slash, eg. `/quit`.
|
||||
|
||||
In scripts and remote control, no slash is needed to perform the command, eg. `quit`.
|
||||
|
||||
> **ℹ️ NOTE: Some commands may not be documented yet or are defined in description of Chat Bots, use `/help` to list them all, or you can contribute to this page.**
|
||||
|
||||
### `animation`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Swing your main or off hand.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/animation <mainhand|offhand>
|
||||
```
|
||||
|
||||
### `bed`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to make the bot sleep easily, all about sleeping in one command.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `bed leave|sleep <x> <y> <z>|sleep <radius>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Leave a bed:
|
||||
|
||||
```
|
||||
/bed leave
|
||||
```
|
||||
|
||||
Sleep in a bed on 124 84 76:
|
||||
|
||||
```
|
||||
/bed sleep 124 84 76
|
||||
```
|
||||
|
||||
Sleep in a bed using relative coordinates:
|
||||
|
||||
```
|
||||
/bed sleep ~ ~ ~-2
|
||||
```
|
||||
|
||||
Automatically find a bed in radius of 50 blocks and sleep in it:
|
||||
|
||||
```
|
||||
/bed sleep 50
|
||||
```
|
||||
|
||||
### `bots`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/bots <list|unload <bot name|all>>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Unload a bot called CustomScript
|
||||
|
||||
```
|
||||
/bots unload CustomScript
|
||||
```
|
||||
|
||||
Unload all bots
|
||||
|
||||
```
|
||||
/bots unload all
|
||||
```
|
||||
|
||||
### `changeslot`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Change your selected slot in the hotbar.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/changeslot <1-9>
|
||||
```
|
||||
|
||||
### `chunk`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Displays the chunk loading status in a nice way.
|
||||
|
||||
> **⚠️ WARNING: To use this feature you need to enable the [Terrain and Movements](configuration.md#terrainandmovements)**
|
||||
|
||||
> **ℹ️ NOTE: You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: [`enableemoji`](configuration.md#enableemoji)**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/chunk status [chunkX chunkZ|locationX locationY locationZ]
|
||||
```
|
||||
|
||||
How it looks:
|
||||
|
||||
|
||||
|
||||
### `dig`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Dig a block on a specific coordinate.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dig <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dig 127 63 12
|
||||
```
|
||||
|
||||
Using relative coordinates:
|
||||
|
||||
```
|
||||
/dig ~ ~-1 ~2
|
||||
```
|
||||
|
||||
### `dropitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Drop all items of a specific type from your inventory.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dropitem <itemtype>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All item types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs).**
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dropitem diamond
|
||||
```
|
||||
|
||||
### `entity`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Attack an entity, use an entity or get a list of entities around you.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Entity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/entity <id|entitytype> <attack|use>
|
||||
```
|
||||
|
||||
Get a list of entities around you:
|
||||
|
||||
```
|
||||
/entity
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All entity types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/EntityType.cs).**
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Attack a Zombie:
|
||||
|
||||
```
|
||||
/entity Zombie attack
|
||||
```
|
||||
|
||||
### `execif`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute a command if a specific condition is met.
|
||||
|
||||
The condition is a C# expression and the local variables you set using [`set`](#set), [`setrnd`](#setrnd) or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.
|
||||
|
||||
Also the instance of MCC is available with `MCC.`.
|
||||
|
||||
> **ℹ️ NOTE: All local variables are treated as strings in the app, when comparing their values, you can use `<variable> == "<value>"`, or better use [`.Equals`](https://www.programiz.com/csharp-programming/library/string/equals) method**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `/execif <condition (C# expression)> ---> <command>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Setting a variable and using it:
|
||||
|
||||
```
|
||||
/set test=Something
|
||||
/execif test == "Something" ---> send Success!
|
||||
```
|
||||
|
||||
```
|
||||
/set test2=1
|
||||
/execif test2 == "1" ---> send Success 2!
|
||||
```
|
||||
|
||||
|
||||
Basic C# expression:
|
||||
|
||||
```
|
||||
/execif 1 + 2 + 3 == 6 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using MCC class:
|
||||
|
||||
```
|
||||
/execif MCC.GetHealth() == 20.0 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using in combination with [`execmulti`](#execmulti):
|
||||
|
||||
```
|
||||
/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3
|
||||
```
|
||||
|
||||
### `execmulti`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute multiple commands in succession on a single line, useful for debugging or when using [`execif`](#execif)
|
||||
|
||||
Commands are separated by `->`
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `execmulti <command 1> -> <command 2> -> <command 3> -> ...`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/execmulti send 1 -> send 2 -> send 3 -> sneak
|
||||
```
|
||||
|
||||
### `quit`
|
||||
|
||||
- **Alias:** `exit`
|
||||
- **Description:**
|
||||
|
||||
Disconnect from the server and close the application
|
||||
|
||||
### `reco`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Disconnect and reconnect to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reco [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `reload`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Reloads settings from MinecraftClient.ini and Chat Bots.
|
||||
|
||||
> **ℹ️ NOTE: Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reload
|
||||
```
|
||||
|
||||
### `connect`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Go to the given server and resume the script
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/connect <server> [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<server>` is either a server IP or a server alias defined in servers file, for more info check out [serverlist](configuration.html#serverlist)**
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `script`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Run a script containing a list of commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/script <script name>
|
||||
```
|
||||
|
||||
### `send`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Send a message or a command to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/send <text>
|
||||
```
|
||||
|
||||
### `respawn`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use this to respawn if you are dead (like clicking "respawn" in-game)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/respawn
|
||||
```
|
||||
|
||||
### `log`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Display some text in the console (useful for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/log <text>
|
||||
```
|
||||
|
||||
- Example:
|
||||
|
||||
```
|
||||
/log this is some text
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- **Description:**
|
||||
|
||||
List players logged in to the server (uses tab list info sent by server)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/list
|
||||
```
|
||||
|
||||
### `set`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a value which can be used as `%variable%` in further commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/set <variable>=<value>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/set abc=123
|
||||
```
|
||||
|
||||
### `setrnd`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a `%variable%` randomly to one of the provided values
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/setrnd <variable> string1 "\"string2\" string3"
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/setrnd <variable> -7to10
|
||||
```
|
||||
|
||||
(Set a `%variable%` to a number from -7 to 9)
|
||||
|
||||
### `sneak`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle sneaking.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/Sneak
|
||||
```
|
||||
|
||||
### `tps`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Get the server TPS (Ticks Per Second).
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/tps
|
||||
```
|
||||
|
||||
### `useitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use item in the hand, this can be used to do a right click on items which open menus on servers.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useitem
|
||||
```
|
||||
|
||||
### `useblock`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Place a block from a hand on a specific coordinate or open an inventory:
|
||||
|
||||
- chest/trap chest
|
||||
- furnace
|
||||
- brewing stand
|
||||
- dispenser/dropper
|
||||
- hopper
|
||||
- shulker
|
||||
- loom
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **ℹ️ NOTE: Not all inventories have a GUI representation in an ASCII art format.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useblock <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/useblock 43 72 7
|
||||
```
|
||||
|
||||
### `follow`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Make the bot follow a player.
|
||||
|
||||
> **ℹ️ NOTE: This command is avaliable only with [Follow Player](chat-bots.md#follow-player) Chat Bot enabled.**
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.** > **ℹ️ NOTE: You need to have [Enity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/follow <player name|stop>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/follow milutinke
|
||||
```
|
||||
|
||||
### `wait`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Wait X ticks (10 ticks = ~1 second. Only for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/wait <time>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/wait 20
|
||||
```
|
||||
|
||||
### `move`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for moving when terrain and movements feature is enabled.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Terrain and Movements](configuration.md#terrainandmovements) is currently not supported in `1.4.6 - 1.6`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Enable gravity
|
||||
|
||||
```
|
||||
/move gravity on
|
||||
```
|
||||
|
||||
Move to coordinates:
|
||||
|
||||
```
|
||||
/move 125 72 34
|
||||
```
|
||||
|
||||
Move to a center of a block:
|
||||
|
||||
```
|
||||
/move center
|
||||
```
|
||||
|
||||
### `look`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for looking at direction when terrain and movements is enabled
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/look <x y z|yaw pitch|up|down|east|west|north|south>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/look up
|
||||
```
|
||||
|
||||
```
|
||||
/look east
|
||||
```
|
||||
|
||||
### `inventory`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for inventory manipulation.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.
|
||||
|
||||
Inventory has slots and each one of them has an id.
|
||||
|
||||
> **ℹ️ NOTE: This command DOES NOT physically open a container (eg. chest), for that you need to use [`useblock`](#useblock) command first.**
|
||||
|
||||
An example of player inventory with annotated IDs in ASCII art and a list of items:
|
||||
|
||||
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: player and container can be simplified with p and c accordingly**
|
||||
|
||||
Actions:
|
||||
|
||||
- `click`
|
||||
- `shiftclick`
|
||||
- `drop`
|
||||
|
||||
Show/Preview items in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id>
|
||||
```
|
||||
|
||||
Click/Shift-Click on an item in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: The default click is left click**
|
||||
|
||||
Close an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> close
|
||||
```
|
||||
|
||||
Drop item(s) from an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id> drop <slot id> <number of items|all>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To drop all items from a slot, you can use:** `all`
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive <slot id> <item type> <amount>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete <slot id>
|
||||
```
|
||||
|
||||
Show all available inventories:
|
||||
|
||||
```
|
||||
/inventory inventories
|
||||
```
|
||||
|
||||
Search for an item of specified type in available inventories:
|
||||
|
||||
```
|
||||
/inventory search <item type>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Show player's inventory:
|
||||
|
||||
```
|
||||
/inventory player
|
||||
```
|
||||
|
||||
Show/Preview items in an inventory using an id:
|
||||
|
||||
```
|
||||
/inventory 3
|
||||
```
|
||||
|
||||
Click on an item in player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player click 36
|
||||
```
|
||||
|
||||
Right-Click on an item in slot number/id `4` in an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 click 4 right
|
||||
```
|
||||
|
||||
Close an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 close
|
||||
```
|
||||
|
||||
Drop a single item from a player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player drop 36 1
|
||||
```
|
||||
|
||||
Drop all items from a player's inventory in slot number/id `37`:
|
||||
|
||||
```
|
||||
/inventory player drop 37 all
|
||||
```
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive 36 diamondblock 64
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory in slot number/id `36` when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete 36
|
||||
```
|
||||
|
||||
Search for 10 Slime Blocks in available inventories:
|
||||
|
||||
```
|
||||
/inventory s SlimeBlock 10
|
||||
```
|
||||
|
||||
### `debug`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle debug messages, useful for chatbot developers.
|
||||
|
||||
### `help`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Show commands help.
|
||||
|
||||
> **ℹ️ NOTE: Use "/send /help" for server help**
|
||||
28
docs/ar/README.md
Normal file
28
docs/ar/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
home: true
|
||||
heroImage: /images/MCC_logo_with_edge.png
|
||||
tagline: 'Minecraft Console Client (MCC) is a lightweight open-source Minecraft Java client implemented in C#'
|
||||
actions:
|
||||
-
|
||||
text: Installation
|
||||
link: ./guide/installation.md
|
||||
type: primary
|
||||
-
|
||||
text: Learn More →
|
||||
link: ./guide/
|
||||
type: secondary
|
||||
actionText:
|
||||
actionLink:
|
||||
features:
|
||||
-
|
||||
title: Chat
|
||||
details: Chat with other people on the server
|
||||
-
|
||||
title: Automation
|
||||
details: Create bots to do automated tasks
|
||||
-
|
||||
title: Supported Versions
|
||||
details: 1.4 - 1.19.2
|
||||
footer: Made by MCC Team with ❤️
|
||||
---
|
||||
|
||||
163
docs/ar/guide/README.md
Normal file
163
docs/ar/guide/README.md
Normal file
|
|
@ -0,0 +1,163 @@
|
|||
# Introduction
|
||||
|
||||
- [About](#about)
|
||||
- [Quick Intro (YouTube Videos)](#quick-intro)
|
||||
- [Features](#features)
|
||||
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
||||
- [Getting Help](#getting-help)
|
||||
- [Submitting a bug report or an idea/feature-request](#bugs-ideas-feature-requests)
|
||||
- [Important notes on some features](#notes-on-some-features)
|
||||
- [Credits](#credits)
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source **Minecraft** TUI client for **Java edition** that allows you to connect to any Minecraft Java 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, as well as extensible C# API for creating Bots.
|
||||
|
||||
It was originally made by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
||||
|
||||
## Features
|
||||
|
||||
- Chat
|
||||
|
||||
- Send and receive chat messages
|
||||
- [Log chat history](chat-bots.md#chat-log)
|
||||
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
|
||||
- [Anti AFK](chat-bots.md#anti-afk)
|
||||
- [Auto Relog](chat-bots.md#auto-relog)
|
||||
- [Script Scheduler](chat-bots.md#script-scheduler)
|
||||
- [Remote Control](chat-bots.md#remote-control)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
- [Auto Attack](chat-bots.md#auto-attack)
|
||||
- [Auto Fishing](chat-bots.md#auto-fishing)
|
||||
- [Auto Eat](chat-bots.md#auto-eat)
|
||||
- [Auto Craft](chat-bots.md#auto-craft)
|
||||
- [Mailer Bot](chat-bots.md#mailer)
|
||||
- [Auto Drop](chat-bots.md#auto-drop)
|
||||
- [Replay Mod](chat-bots.md#replay-mod)
|
||||
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
||||
- [Docker Support](installation.md#using-docker)
|
||||
- [Inventory Handling](usage.md#inventory)
|
||||
- [Terrain Traversing](usage.md#move)
|
||||
- Entity Handling
|
||||
|
||||
_NOTE: Some of mentioned features are disabled by default and you will have to turn them on in the configuration file and some may require additional configuration on your part for your specific usage._
|
||||
|
||||
## Why Minecraft Console Client?
|
||||
|
||||
- Easy to use
|
||||
- Helpful community
|
||||
- Open-Source
|
||||
- Fast performance
|
||||
- Cross-Platform
|
||||
- Docker Support
|
||||
- 10 years of continuous development
|
||||
- Active contributors
|
||||
- Widely used
|
||||
|
||||
## Quick Intro
|
||||
|
||||
Don't have time to read through the documentation, we got you, our community has made some simple introduction videos about the **Minecraft Console Client**.
|
||||
|
||||
### The list of the tutorials:
|
||||
|
||||
Installation:
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
Using Commands, Scripts and other features:
|
||||
|
||||
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
||||
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
||||
|
||||
## Getting Help
|
||||
|
||||
MCC has a community that is willing to help, we have a Discussions section in out Git Hub repository.
|
||||
|
||||
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) to access it.
|
||||
|
||||
### Before getting help
|
||||
|
||||
- **Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!**
|
||||
- **Please be kind and patient, respect others as they're the ones using their time to help you**
|
||||
|
||||
## Bugs, Ideas, Feature Requests
|
||||
|
||||
Bug reporting, idea submitting or feature requesting are done in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [Github repository]([here](https://github.com/MCCTeam/Minecraft-Console-Client)).
|
||||
|
||||
Navigate to the Issues section, search for a bug, idea or a feature using the search option here in the documentation and in the `Issues` section on Git Hub before making your own.
|
||||
|
||||
If you haven't found anything similar, go ahead and click on the `New issue` button, then choose what you want to do.
|
||||
|
||||
If you're reporting a bug, please be descriptive as much as possible, try to explain how to re-create the bug, attack screenshots and logs, make sure that you have [`debugmessages`](configuration.me#debugmessages) set to `true` before sending a bug report or taking a screenshot.
|
||||
|
||||
### Before submitting
|
||||
|
||||
- **Please use the search option here or in the `Issues` section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!**
|
||||
- **Please be kind, patient and respect others. Thank you!**
|
||||
|
||||
## Notes on some features
|
||||
|
||||
### Inventory, Terrain and Entity Handling
|
||||
|
||||
Inventory handling is currently not supported in versions: `1.4.6 - 1.9`
|
||||
|
||||
Terrain handling is currently not supported in versions: `1.4.6 - 1.6`
|
||||
|
||||
Entity handling is currently not supported in versions: `1.4.6 - 1.9` (but `1.8` and `1.9` are being worked on, almost at the working state, only `EntityMetadata` packet remains to be fixed)
|
||||
|
||||
There features might not always be implemented in the latest version of the game, since they're often subjected to major changes by Mojang, and we need some time to figure out what has changed and to implement the required changes.
|
||||
|
||||
If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.
|
||||
|
||||
## Credits
|
||||
|
||||
_Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
||||
|
||||
Many features would not have been possible without the help of our talented community:
|
||||
|
||||
**Maintainers**
|
||||
|
||||
ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte
|
||||
|
||||
**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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
||||
|
||||
**Bug Hunters**
|
||||
|
||||
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, 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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
||||
|
||||
**Contributors**
|
||||
|
||||
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
||||
|
||||
**Libraries:**
|
||||
|
||||
Minecraft Console Client also borrows code from the following libraries:
|
||||
|
||||
| Name | Purpose | Author | License |
|
||||
| ----------- | ---------------- | ---------------- | ------- |
|
||||
| Biko | Proxy handling | Benton Stark | MIT |
|
||||
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
||||
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
||||
|
||||
## Disclaimer
|
||||
|
||||
Even if everything should work, we are not responsible for 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 from the source code.
|
||||
|
||||
Also, remember that when you connect to a server with this program, you will appear where you left the last time. This means that **you can die if you log in in an unsafe place on a survival server!** Use the script scheduler bot to send a teleport command after logging in.
|
||||
|
||||
We remind you that **you may get banned** by your server for using this program. Use accordingly with server rules.
|
||||
|
||||
## License
|
||||
|
||||
Minecraft Console Client is a totally free of charge, open source project. The source code is available at [Github Repository](https://github.com/MCCTeam/Minecraft-Console-Client)
|
||||
|
||||
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html) Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|
||||
1921
docs/ar/guide/chat-bots.md
Normal file
1921
docs/ar/guide/chat-bots.md
Normal file
File diff suppressed because it is too large
Load diff
1185
docs/ar/guide/configuration.md
Normal file
1185
docs/ar/guide/configuration.md
Normal file
File diff suppressed because it is too large
Load diff
76
docs/ar/guide/contibuting.md
Normal file
76
docs/ar/guide/contibuting.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# Contributing
|
||||
|
||||
At this moment this page needs to be created.
|
||||
|
||||
For now you can use our article from the [Git Hub repository Wiki](https://github.com/MCCTeam/Minecraft-Console-Client/wiki/Update-console-client-to-new-version) written by [ReinforceZwei](https://github.com/ReinforceZwei).
|
||||
|
||||
## Translations
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* **`en.ini` : English - English**
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
### Add new translation
|
||||
|
||||
1. First you need to get the name of the translated file.
|
||||
* Visit [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) and find the first occurrence of the language you need to translate in the table below.
|
||||
* Use the language code of the row in the table as the name of the translation file.
|
||||
* For example:
|
||||
* `English` -> row `English 0x0009` -> `en` -> `en.ini`
|
||||
* `Chinese (Traditional)` -> row `Chinese (Traditional) 0x7C04` -> `zh-Hant` -> `zh-Hant.ini`
|
||||
|
||||
2. Which system languages are recommended to use this translation?
|
||||
* Still check the table in [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c), one language may have multiple rows.
|
||||
* You will need to indicate which language codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `de.ini` applies to `de`, `de-AT`, `de-BE`, `de-DE`, ...
|
||||
* Translation `zh-Hans.ini` applies to `zh-Hans`, `zh`, `zh-CN`, `zh-SG`.
|
||||
|
||||
3. Which game languages are recommended to use this translation?
|
||||
* Check out the table in [this link](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239), where the `Locale Code` column indicates the language code in minecraft.
|
||||
* You will need to indicate which locale codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `fr.ini` applies to `fr_ca`, `fr_fr`.
|
||||
* Translation `zh-Hans.ini` applies to `zh_cn`.
|
||||
|
||||
4. Add the new translation to the code. (Optional)
|
||||
* **If you are not familiar with programming, you can skip this step and just write the above information in your PR or issue.**
|
||||
* Add the newly created translation file `xx.ini` to the project `/Resources/lang/xx.ini`.
|
||||
* Open `/DefaultConfigResource.resx`.
|
||||
* Click `Add Resources`.
|
||||
* Choose `/Resources/lang/xx.ini`.
|
||||
* Rename the added resource file in `/DefaultConfigResource.resx` to `Translation_xx`.
|
||||
* Open `/Translations.cs`.
|
||||
* Find `public static Tuple<string, string[]> GetTranslationPriority();`
|
||||
* Update the mapping of system language codes to translation files.
|
||||
* Find `public static string[] GetTranslationPriority(string gameLanguage);`
|
||||
* Update the mapping of game locale code to translation files.
|
||||
|
||||
5. Follow the section "Update existing translation".
|
||||
|
||||
### Update existing translation
|
||||
|
||||
1. Visit [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang), download `en.ini` and the language you want to translate(`xx.ini`).
|
||||
|
||||
2. Compare `en.ini` and `xx.ini` and update outdated or non-existent entries in `xx.ini`.
|
||||
|
||||
3. 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.
|
||||
|
||||
### Translate README.md
|
||||
|
||||
1. Get the English version of the README.md from [here](https://raw.githubusercontent.com/MCCTeam/Minecraft-Console-Client/master/README.md).
|
||||
|
||||
2. See `Add new translation -> 1.` for the target language code. Assume it is `xx`.
|
||||
|
||||
3. Complete the translation according to the English README.md and name the translated version as `README-xx.md`.
|
||||
|
||||
4. In the English README, above the "About" section, add the name of the language and a hyperlink to `README-xx.md`.
|
||||
|
||||
## Contributors
|
||||
|
||||
[Check out our contributors on Github](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors).
|
||||
170
docs/ar/guide/creating-bots.md
Normal file
170
docs/ar/guide/creating-bots.md
Normal file
|
|
@ -0,0 +1,170 @@
|
|||
# Creating Chat Bots
|
||||
|
||||
- [Notes](#notes)
|
||||
- [Requirements](#requirements)
|
||||
- [Quick Introduction](#quick-introduction)
|
||||
- [Examples](#examples)
|
||||
- [C# API](#c#-api)
|
||||
|
||||
## Notes
|
||||
|
||||
> **ℹ️ NOTE: For now this page contains only the bare basics of the Chat Bot API, enough of details to teach you how to make basic Chat Bots. For more details you need to take a look at the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) and [Examples](#examples). This page will be improved in the future.**
|
||||
|
||||
**Minecraft Console Client** has a rich C# API which allows you to create Chat Bots (effectively plugins) which can help you create complex automations which normal scripts may not be able to do.
|
||||
|
||||
## Requirements
|
||||
|
||||
- A basic knowledge of C# programming language
|
||||
- A text editor
|
||||
|
||||
If you're not familiar with the C# programming language, we suggest taking a look at the following resources:
|
||||
|
||||
Crash courses:
|
||||
|
||||
- [C# Crash Course playlist by Teddy Smit](https://www.youtube.com/watch?v=67oWw9TanOk&list=PL82C6-O4XrHfoN_Y4MwGvJz5BntiL0z0D)
|
||||
|
||||
More in-depth:
|
||||
|
||||
- [Learn C# Youtube Playlist by Microsoft](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oVxKLQCHpiUWun7vlJJvUiN)
|
||||
- [Getting started with C# (An index of tutorials and the documentation) by Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/)
|
||||
|
||||
## Quick Introduction
|
||||
|
||||
This introduction assumes that you have the basic knowledge of C#.
|
||||
|
||||
> **ℹ️ NOTE: Here we will use terms Chat Bot and Script interchangeably**
|
||||
|
||||
Create a new empty file and name it `ExampleChatBot.cs` in the same folder where you have your MCC installed.
|
||||
|
||||
Paste the following example code:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
|
||||
// The code and comments above are defining a "Script Metadata" section
|
||||
|
||||
// Every single chat bot (script) must be a class which extends the ChatBot class.
|
||||
// Your class must be instantiates in the "Script Metadata" section and passed to MCC.LoadBot function.
|
||||
class ExampleChatBot : ChatBot
|
||||
{
|
||||
// This method will be called when the script has been initialized for the first time, it's called only once
|
||||
// Here you can initialize variables, eg. Dictionaries. etc...
|
||||
public override void Initialize()
|
||||
{
|
||||
LogToConsole("An example Chat Bot has been initialized!");
|
||||
}
|
||||
|
||||
// This is a function that will be run when we get a chat message from a server
|
||||
// In this example it just detects the type of the message and prints it out
|
||||
public override void GetText(string text)
|
||||
{
|
||||
string message = "";
|
||||
string username = "";
|
||||
text = GetVerbatim(text);
|
||||
|
||||
if (IsPrivateMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has sent you a private message: " + message);
|
||||
}
|
||||
else if (IsChatMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has said: " + message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Start MCC, connect to a server and run the following internal command: `/script ExampleChatBot.cs`.
|
||||
|
||||
If you did everything right you should see: `[Example Chat Bot] An example Chat Bot has been initialised!` message appear in your console log.
|
||||
|
||||
### Structure of Chat Bots
|
||||
|
||||
Chat Bot (Script) structure is the following:
|
||||
|
||||
```
|
||||
<script metadata>
|
||||
<chat bot class>
|
||||
```
|
||||
|
||||
**Script Metadata** is a section with a custom format that mixes in C# with our format using comments. Every single Chat Bot (Script) must have this section at the beginning in order to work.
|
||||
|
||||
### Script Metadata Format
|
||||
|
||||
`//MCCScript 1.0` marks the beginning of the **Script Metadata** section, this must always be on the first line or the Chat Bot (Script) will not load and will throw an error.
|
||||
|
||||
`//MCCScript Extensions` marks the end of the **Script Metadata** section, this must be defined before a Chat Bot (Script) class.
|
||||
|
||||
In order for your Chat Bot (Script) to properly load in-between the `//MCCScript 1.0` and the `//MCCScript Extensions` lines you must instantiate your Chat Bot (Script) class and pass it to the `MCC.LoadBot` function.
|
||||
|
||||
Example code:
|
||||
|
||||
```
|
||||
MCC.LoadBot(new YourChatBotClassNameHere());
|
||||
```
|
||||
|
||||
**Script Metadata** section allows for including C# packages and libraries with: `//using <namespace>` and `/dll <dll name>`.
|
||||
|
||||
> **ℹ️ NOTE: Avoid adding whitespace between `//` and keywords**
|
||||
|
||||
By the default the following packages are loaded:
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Text.RegularExpressions;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.IO;
|
||||
using System.Net;
|
||||
using System.Threading;
|
||||
using MinecraftClient;
|
||||
using MinecraftClient.Mapping;
|
||||
using MinecraftClient.Inventory;
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```csharp
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
```
|
||||
|
||||
Full Example:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
```
|
||||
|
||||
### Chat Bot Class
|
||||
|
||||
After the end of the **Script Metadata** section, you basically can define any number of classes you like, the only limitation is that the main class of your Chat Bot (Script) must extend `ChatBot` class.
|
||||
|
||||
There are no required methods, everything is optional.
|
||||
|
||||
When the Chat Bot (Script) has been initialized for the first time the `Initialize` method will be called. In it you can initialize variables, eg. Dictionaries, etc..
|
||||
|
||||
> **ℹ️ NOTE: For allocating resources like a database connection, we recommend allocating them in `AfterGameJoined` and freeing them in `OnDisconnect`**.
|
||||
|
||||
## Examples
|
||||
|
||||
You can find a lot of examples in our Git Hub Repository at [ChatBots](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/ChatBots) and [config](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config).
|
||||
|
||||
## C# API
|
||||
|
||||
As of the time of writing, the C# API has been changed in forks that are yet to be merged, so for now you can use the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) for reference.
|
||||
|
||||
Each method is well documented with standard C# documentation comments.
|
||||
|
||||
In the future we will make a script to auto-generate this section based on the documentation in the code.
|
||||
931
docs/ar/guide/installation.md
Normal file
931
docs/ar/guide/installation.md
Normal file
|
|
@ -0,0 +1,931 @@
|
|||
# Installation
|
||||
|
||||
- [YouTube Tutorials](#youtube-tutorials)
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker)
|
||||
- [Run on Android](#run-on-android)
|
||||
- [Run MCC 24/7 on a VPS](#run-on-a-vps)
|
||||
|
||||
## YouTube Tutorials
|
||||
|
||||
If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
## Download a compiled binary
|
||||
|
||||
In order to run **Minecraft Console Client** you need [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download)
|
||||
|
||||
> **⚠️ IMPORTANT: If you already have .NET, but an older version than `6.0`, please update to `6.0` since MCC might not work as expected or at all.**
|
||||
|
||||
#### How to install .NET on your platform
|
||||
|
||||
- [Install .NET on Windows](https://docs.microsoft.com/en-us/dotnet/core/install/windows)
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Download
|
||||
|
||||
You can download a compiled binary file of the latest build from our Releases section on Git Hub: [Download](https://github.com/MCCTeam/Minecraft-Console-Client/releases)
|
||||
|
||||
## Building from the source code
|
||||
|
||||
### Windows
|
||||
|
||||
Requirements:
|
||||
|
||||
- [Git](https://www.git-scm.com/)
|
||||
- [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
Install [Git](https://www.git-scm.com/)
|
||||
|
||||
1. Make a new folder where you want to keep the source code
|
||||
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
|
||||
3. Click on `Git Bash Here` in the context menu
|
||||
4. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
|
||||
6. Open up the new cloned folder
|
||||
|
||||
#### Building using the Visual Studio
|
||||
|
||||
1. Open up the `MinecraftClient.sln` via Visual Studio
|
||||
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
3. Click on `Properties`
|
||||
4. Open up the `Build` tab and select configuration `Release`
|
||||
5. Press `CTRL + S` and close the file
|
||||
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
7. Click `Build`
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
#### Building using .NET manually without Visual Studio
|
||||
|
||||
1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
|
||||
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
|
||||
3. Run the following command to build the project:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r win-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
### Linux, macOS
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
|
||||
- Linux:
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**
|
||||
|
||||
- [Install Git on macOS](https://git-scm.com/download/mac)
|
||||
|
||||
- .NET SDK 6.0 or new-er
|
||||
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
1. Open up a terminal emulator and navigate to the folder where you will store the MCC
|
||||
2. Recursively clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)
|
||||
4. Run the following command to build the project:
|
||||
|
||||
- On Linux:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r linux-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux that is either ARM, 32-bit, Rhel based, Using Musl, or Tirzen, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace the `'-r linux-64` with an appropriate `-r <your RID>` (Example for arm: `-r linux-arm64`)**
|
||||
|
||||
- On macOS:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r osx-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're not using MAC with Intel, find an appropriate RID for your ARM processor, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) and replace the `'-r osx-64` with an appropriate `-r <your RID>` (Example for arm: `-r osx.12-arm64`)**
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient` will be in:
|
||||
|
||||
- Linux: `MinecraftClient/bin/Release/net6.0/linux-x64/publish/`
|
||||
- macOS: `MinecraftClient/bin/Release/net6.0/osx-x64/publish/`
|
||||
|
||||
## Using Docker
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
- Docker
|
||||
|
||||
> **ℹ️ NOTE: This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**
|
||||
|
||||
> **⚠️ WARNING: Pay attention at warnings, Docker currently works, but you must start the containers in the interactive mode or MCC will crash, we're working on solving this.**
|
||||
|
||||
1. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
2. Navigate to `Minecraft-Console-Client/Docker`
|
||||
3. Build the image using the following command
|
||||
|
||||
```bash
|
||||
docker build -t minecraft-console-client:latest .
|
||||
```
|
||||
|
||||
**Start the container using Docker:**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: There is a bug with the ConsoleInteractive which causes a crash when a container is started in a headless mode, so you need to use the interactive mode. Do not restart containers in a classic way, stop then and start them with interactive mode (this command), after that simply detach with `CTRL + P` and then `CTRL + Q`.**
|
||||
|
||||
```bash
|
||||
# You could also ignore the -v parameter if you dont want to mount the volume that is up to you. If you don't it's harder to edit the .ini file if thats something you want to do
|
||||
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
|
||||
```
|
||||
|
||||
Now you could login and the Client is running. To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`. To reattach use the `docker attach` command.
|
||||
|
||||
**Start the container using docker-compose:**
|
||||
|
||||
By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.
|
||||
|
||||
If you don't want to map a volume, you have to comment out or delete the entire volumes section:
|
||||
|
||||
```yml
|
||||
#volumes:
|
||||
#- './data:/opt/data'
|
||||
```
|
||||
|
||||
Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:
|
||||
|
||||
```bash
|
||||
docker-compose run MCC
|
||||
```
|
||||
|
||||
Remember to remove the container after usage:
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
If you use the INI file and entered your data (username, password, server) there, you can start your container using
|
||||
|
||||
```bash
|
||||
docker-compose up
|
||||
docker-compose up -d #for deamonized running in the background
|
||||
```
|
||||
|
||||
Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`. As above, you can stop and remove the container using
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Run on Android
|
||||
|
||||
It is possible to run the Minecraft Console Client on Android through Termux and Ubuntu 22.04 in it, however it requires a manual setup with a lot of commands, be careful no to skip any steps. Note that this might take anywhere from 10 to 20 minutes or more to do depending on your technical knowledge level, Internet speed and CPU speed.
|
||||
|
||||
> **ℹ️ NOTE: This section is going to get a bit technical, I'll try my best to make everything as simple as possible. If you are having trouble following along or if you encounter any issues, feel free to open up a discussion on our Github repository page.**
|
||||
|
||||
> **ℹ️ NOTE: You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**
|
||||
|
||||
> **ℹ️ NOTE: Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**
|
||||
|
||||
### Installation
|
||||
|
||||
#### Termux
|
||||
|
||||
> **⚠️ IMPORTANT: The Play Store version of Termux is outdated and not supported, do not use it, use the the [Github one](https://github.com/termux/termux-app/releases/latest/).**
|
||||
|
||||
Go to [the Termux Github latest release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it and run it.
|
||||
|
||||
> **ℹ️ NOTE: If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!**
|
||||
|
||||
#### Installing Ubuntu 22.04
|
||||
|
||||
At this stage, you have 2 options:
|
||||
|
||||
1. Following this textual tutorial
|
||||
2. Watching a [Youtube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM)
|
||||
|
||||
> **ℹ️ NOTE: If you decide to watch the Youtube tutorial, watch only up to `1:58`, the steps after are not needed and might just confuse you.**
|
||||
|
||||
In order to install Ubuntu 22.04 in Termux you require `wget` and `proot`, we're going to install them in the next step.
|
||||
|
||||
Once you have Termux installed open it up and run the following command one after other (in order):
|
||||
|
||||
1. `pkg update`
|
||||
2. `pkg upgrade`
|
||||
3. `pkg install proot wget`
|
||||
|
||||
> **ℹ️ NOTE: If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter**
|
||||
|
||||
Then you need to download an installation script using the following command:
|
||||
|
||||
```bash
|
||||
wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh
|
||||
```
|
||||
|
||||
Once the script has downloaded, run it with:
|
||||
|
||||
```bash
|
||||
bash ubuntu.sh
|
||||
```
|
||||
|
||||
Then you will be asked a question, enter `Y` and press `Enter`. Once the installation is complete, you can start Ubuntu with:
|
||||
|
||||
```bash
|
||||
./startubuntu.sh
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command**
|
||||
|
||||
#### Installing .NET on ARM
|
||||
|
||||
Since there are issues installing .NET 6.0 via the APT package manager at the time of writing, we will have to install it manually.
|
||||
|
||||
First we need to update the APT package manager repositories and install dependencies.
|
||||
|
||||
To update the APT repositories, run the following command:
|
||||
|
||||
```bash
|
||||
apt update -y && apt upgrade -y
|
||||
```
|
||||
|
||||
After you did it, we need to install dependencies for .NET, with the following command:
|
||||
|
||||
```bash
|
||||
apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y
|
||||
```
|
||||
|
||||
After you have installed dependencies, it's time to install .NET, you either can follow this tutorial or the [Microsoft one](https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install).
|
||||
|
||||
Navigate to your `/root` home directory with the following command:
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
```
|
||||
|
||||
First you need to download .NET 6.0, you can do it with the following command:
|
||||
|
||||
```bash
|
||||
wget https://download.visualstudio.microsoft.com/download/pr/901f7928-5479-4d32-a9e5-ba66162ca0e4/d00b935ec4dc79a27f5bde00712ed3d7/dotnet-sdk-6.0.400-linux-arm64.tar.gz
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you have 64 bit version of ARM processor, if you happen to have a 32-bit version replace the link in the command above with [this one](https://download.visualstudio.microsoft.com/download/pr/cf567026-a29a-41aa-bc3a-e4e1ad0df480/0925d411e8e09e31ba7a39a3eb0e29af/aspnetcore-runtime-6.0.8-linux-arm.tar.gz)**.
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you're following along and using Ubuntu 22.04, if you're using a different distro, like Alpine, go to [here](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) and copy an appropriate link for your distro.**
|
||||
|
||||
Once the file has been downloaded, you need to run the following commands in order:
|
||||
|
||||
1. `DOTNET_FILE=dotnet-sdk-6.0.400-linux-arm64.tar.gz`
|
||||
|
||||
> **⚠️ IMPORTANT: If you're using a different download link, update the file name in this command to match your version.**
|
||||
|
||||
2. `export DOTNET_ROOT=/root/.dotnet`
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"`
|
||||
4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools`
|
||||
|
||||
Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located.
|
||||
|
||||
> **⚠️ IMPORTANT: You will need a basic knowledge of Nano text editor, if you do not know how to use it, watch this [Youtube video tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A)**
|
||||
|
||||
To enable this, we need to edit our `/root/.bashrc` file with the following command:
|
||||
|
||||
```bash
|
||||
nano /root/.bashrc
|
||||
```
|
||||
|
||||
Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text:
|
||||
|
||||
```bash
|
||||
export DOTNET_ROOT=/root/.dotnet/
|
||||
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
|
||||
```
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter.
|
||||
|
||||
Veryfy that .NET was installed correctly by running:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get a help page:
|
||||
|
||||
```bash
|
||||
root@localhost:~# dotnet
|
||||
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
#### Installing MCC
|
||||
|
||||
Finally, we can install MCC.
|
||||
|
||||
> **⚠️ IMPORTANT: If you have a 32 ARM processor, you need to build the MCC yourself, take a look at the [Building From Source](#building-from-the-source-code) section. Also make sure to be using the appropriate `-r` parameter value for your architecture.**
|
||||
|
||||
Let's make a folder where the MCC will be stored with the following command:
|
||||
|
||||
```bash
|
||||
mkdir MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Then enter it the newly created folder:
|
||||
|
||||
```bash
|
||||
cd MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Download the MCC with the following command:
|
||||
|
||||
```bash
|
||||
wget https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest/download/MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
Unzip it with the following command:
|
||||
|
||||
```bash
|
||||
unzip MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
You can remove the zip archive now, we do not need it anymore, with:
|
||||
|
||||
```bash
|
||||
rm MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
And finally run it with:
|
||||
|
||||
```
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
#### After installation
|
||||
|
||||
When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh`
|
||||
|
||||
Then you can start the MCC again with `./MinecraftClient`
|
||||
|
||||
To stop MCC from running you can press `CTRL + C`
|
||||
|
||||
To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use, if you have followed the installation steps above, you should be familiar with it, if not, check out [this tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).
|
||||
|
||||
For downloading files, you can use the `wget` file we have installed, simply run: `wget your_link_here` (you have examples above, and a video tutorial down bellow).
|
||||
|
||||
Also, here are some linux tutorials for people who are new to it:
|
||||
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
## Run on a VPS
|
||||
|
||||
> **ℹ️ NOTE: This is a new section, if you find a mistake, please report it by opening an Issue in our [Github repository](https://github.com/MCCTeam/Minecraft-Console-Client). Thank you!**
|
||||
|
||||
The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.
|
||||
|
||||
- [What is a VPS?](#what-is-a-vps)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Where to get a VPS](#where-to-get-a-vps)
|
||||
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
|
||||
- [Initial VPS setup](#initial-vps-setup)
|
||||
- [Creating a new user account](#creating-a-new-user)
|
||||
- [Installing .NET Core 6](#installing-net-core-6)
|
||||
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)
|
||||
|
||||
### What is a VPS?
|
||||
|
||||
VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).
|
||||
|
||||
You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.
|
||||
|
||||
Here is a [Youtube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you're interested.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. Gitbash (if you're on Windows)
|
||||
|
||||
Download and install [Gitbash](https://git-scm.com/downloads).
|
||||
|
||||
> **ℹ️ NOTE: Make sure to allow the installation to add it to the context menu**
|
||||
|
||||
2. `ssh` and `ssh-keygen` commands (On Windows they're available with Gitbash, on macOs and Linux they should be available by default, it not, search on how to install them)
|
||||
|
||||
3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.
|
||||
|
||||
If you already know this, feel free to skip.
|
||||
|
||||
if you get stuck, watch those tutorials.
|
||||
|
||||
If you're new to this, you can learn about it here:
|
||||
|
||||
- [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
### Where to get a VPS
|
||||
|
||||
You have 2 options:
|
||||
|
||||
- [Buying a VPS](#buying-a-vps)
|
||||
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)
|
||||
|
||||
#### Buying a VPS
|
||||
|
||||
If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.
|
||||
|
||||
**What hardware requirements I need for running the MCC?**
|
||||
|
||||
The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.
|
||||
|
||||
**Where to buy a VPS?**
|
||||
|
||||
> **⚠️ VERY IMPORTANT: In this tutorial we will be using `Ubuntu 22.04`, make sure to select it as the OS when buying a VPS.**
|
||||
|
||||
Some of the reliable and cheap hosting providers (sorted for price/performance):
|
||||
|
||||
- [E-Trail](https://e-trail.net/vps)
|
||||
|
||||
**Minimum price**: `2.50 EUR / month`
|
||||
|
||||
> **ℹ️ NOTE: Does not have Ubuntu 22.04 in the dropdown menu when ordering, you will have to re-install later or ask support to do it.**
|
||||
|
||||
- [OVH Cloud](https://www.ovhcloud.com/de/vps/)
|
||||
|
||||
**Minimum price**: `3.57 EUR / month`
|
||||
|
||||
- [Hetzner Cloud](https://www.hetzner.com/cloud)
|
||||
|
||||
**Minimum price**: `4.51 EUR / month`
|
||||
|
||||
- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)
|
||||
|
||||
**Minimum price**: `4 EUR / month`
|
||||
|
||||
- [Contabo](https://contabo.com/en/vps/)
|
||||
|
||||
**Minimum price**: `7 EUR / month`
|
||||
|
||||
**More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**
|
||||
|
||||
You also may want to search for better deals.
|
||||
|
||||
#### AWS EC2 VPS
|
||||
|
||||
> **⚠️ VERY IMPORTANT: This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**
|
||||
|
||||
> **⚠️ WARNING: Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**
|
||||
|
||||
> **⚠️ WARNING: Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**
|
||||
|
||||
> **ℹ️ NOTE: If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**
|
||||
|
||||
Register on AWS and enter all of your billing info and a phone number. Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).
|
||||
|
||||
### Initial Amazon VPS setup
|
||||
|
||||
> **ℹ️ NOTE: Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**
|
||||
|
||||
When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`
|
||||
|
||||
> **ℹ️ NOTE: Make sure to select the region closest to you for the minimal latency**
|
||||
|
||||
Click on the **Launch instance** button.
|
||||
|
||||
Fill out the `Name` field with a name of your preference.
|
||||
|
||||
|
||||
|
||||
For the **Application and OS images** select `Ubuntu Server 22.04 LTS (HVM), SSD Volume Type`.
|
||||
|
||||
> **⚠️ VERY IMPORTANT: Make sure that it has `Free tier eligible` next to it.**
|
||||
|
||||
|
||||
|
||||
For the **Instance type** select `t2.micro`.
|
||||
|
||||
For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.
|
||||
|
||||
> **⚠️ EXTREMELY IMPORTANT: Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**
|
||||
|
||||
|
||||
|
||||
For the **Network settings** check the following checkboxes on:
|
||||
|
||||
- `Allow SSH traffic from` (Anywhere)
|
||||
- `Allow HTTPs traffic from the internet`
|
||||
- `Allow HTTP traffic from the internet`
|
||||
|
||||
> **ℹ️ NOTE: The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**
|
||||
|
||||
|
||||
|
||||
For the **Storage** enter `30`.
|
||||
|
||||
|
||||
|
||||
Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.
|
||||
|
||||
Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.
|
||||
|
||||
You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
In order to login with SSH, you are going to use the following command:
|
||||
|
||||
```bash
|
||||
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<` and `>` are not typed, that is just a notation for a placeholder!**
|
||||
|
||||
> **ℹ️ NOTE: `ubuntu` is a default root account username for Ubuntu on AWS!**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
|
||||
```
|
||||
|
||||
If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.
|
||||
|
||||
Now you can continue to [Creating a new user](#creating-a-new-user)
|
||||
|
||||
### Initial VPS setup
|
||||
|
||||
> **ℹ️ NOTE: This section if for those who do not use AWS, if you use AWS skip it**
|
||||
|
||||
When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.
|
||||
|
||||
Other option is that you will get your login info in the email once the setup is done.
|
||||
|
||||
Once you have the root login account info, you need [Gitbash](https://git-scm.com/downloads) on Windows and `ssh` if you're on macOS or Linux (if you do not have it by some chance, search on how to install it, it is simple).
|
||||
|
||||
If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:
|
||||
|
||||
```bash
|
||||
ssh <username>@<ip>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh root@142.26.73.14
|
||||
```
|
||||
|
||||
Example with port:
|
||||
|
||||
```bash
|
||||
ssh -p 2233 root@142.26.73.14
|
||||
```
|
||||
|
||||
Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.
|
||||
|
||||
### Creating a new user
|
||||
|
||||
Once you've logged in to your VPS you need to create a new user and give it SSH access.
|
||||
|
||||
In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.
|
||||
|
||||
> **ℹ️ NOTE: You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**
|
||||
|
||||
To create a new user named `mcc` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo useradd mcc -m
|
||||
```
|
||||
|
||||
Now we need to give it a password, execute the following command, type the password and confirm it:
|
||||
|
||||
```bash
|
||||
sudo passwd mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: When you're typing a password it will not be displayed on the screen, but you're typing it for real.**
|
||||
|
||||
> **ℹ️ NOTE: Make sure you have a strong password!**
|
||||
|
||||
Now we need to give our user account the admin permissions:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG sudo mcc
|
||||
```
|
||||
|
||||
Now we are going to set it's shell to bash:
|
||||
|
||||
```bash
|
||||
sudo chsh mcc -s /bin/bash
|
||||
```
|
||||
|
||||
Now we need to log in as the `mcc` user:
|
||||
|
||||
```bash
|
||||
su mcc
|
||||
```
|
||||
|
||||
Fill in your password when asked.
|
||||
|
||||
Navigate to the `mcc` user home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Make a new `.ssh` directory:
|
||||
|
||||
```bash
|
||||
mkdir .ssh
|
||||
```
|
||||
|
||||
Enter it with:
|
||||
|
||||
```bash
|
||||
cd .ssh
|
||||
```
|
||||
|
||||
Make a new empty file named `authorized_keys`:
|
||||
|
||||
```bash
|
||||
touch authorized_keys
|
||||
```
|
||||
|
||||
Do no close the Git bash/Terminal emulator. On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account. Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
Type the following command:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t RSA -b 4096
|
||||
```
|
||||
|
||||
Enter the name of the key file to be: `MCC_Key`, press Enter.
|
||||
|
||||
When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.
|
||||
|
||||
This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.
|
||||
|
||||
Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.
|
||||
|
||||
Return to the Git Bash/Terminal emulator and execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install nano -y
|
||||
```
|
||||
|
||||
This will install the Nano editor on your VPS.
|
||||
|
||||
Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.
|
||||
|
||||
Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:
|
||||
|
||||
```bash
|
||||
pwd
|
||||
```
|
||||
|
||||
If it does not print `/home/mcc/.ssh`, navigate to it with:
|
||||
|
||||
```bash
|
||||
cd /home/mcc/.ssh
|
||||
```
|
||||
|
||||
Now you need to open the `authorized_keys` file with the nano editor:
|
||||
|
||||
```bash
|
||||
nano authorized_keys
|
||||
```
|
||||
|
||||
Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.
|
||||
|
||||
Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.
|
||||
|
||||
Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:
|
||||
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
```
|
||||
|
||||
Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.
|
||||
|
||||
Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.
|
||||
|
||||
Additionally for better security you can do the following:
|
||||
|
||||
- Set `PermitRootLogin` to `yes`
|
||||
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
|
||||
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)
|
||||
|
||||
Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.
|
||||
|
||||
Now we need to restart the SSHD service with:
|
||||
|
||||
```bash
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
Let's check if everything is working correctly:
|
||||
|
||||
```bash
|
||||
sudo systemctl status sshd
|
||||
```
|
||||
|
||||
If everything has been configured as it should be you should see `active (running)` as a status of the service. If not, open the config file again and check for mistakes.
|
||||
|
||||
Press `q` to exit the log mode.
|
||||
|
||||
Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.
|
||||
|
||||
Now we can login to the user with our private `MCC_Key` file.
|
||||
|
||||
Command:
|
||||
|
||||
```bash
|
||||
ssh -i <path to the MCC_Key private key> mcc@<ip here>
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i MCC_Key mcc@3.71.108.69
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**
|
||||
|
||||
If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.
|
||||
|
||||
You can do `whoami` to see your username.
|
||||
|
||||
Now you can install .NET Core 6 and MCC.
|
||||
|
||||
### Installing .NET Core 6
|
||||
|
||||
> **ℹ️ NOTE: If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**
|
||||
|
||||
> **⚠️ WARNING: With newer versions of .NET Core 6 on Ubuntu 22.04 you might get the following error: `A fatal error occurred, the folder [/usr/share/dotnet/host/fxr] does not contain any version-numbered child folders`, if you get it, use [this solution](https://github.com/dotnet/sdk/issues/27082#issuecomment-1211143446)**
|
||||
|
||||
Log in as the user you've created.
|
||||
|
||||
Update the system packages and package manager repositories:
|
||||
|
||||
```bash
|
||||
sudo apt update -y && sudo apt upgrade -y
|
||||
```
|
||||
|
||||
Install `wget`:
|
||||
|
||||
```bash
|
||||
sudo apt install wget -y
|
||||
```
|
||||
|
||||
Go to your home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Download the Microsoft repository file:
|
||||
|
||||
```bash
|
||||
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Add Microsoft repositories to the package manager:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Remove the file, we do not need it anymore:
|
||||
|
||||
```bash
|
||||
rm packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Finally, install .NET Core 6:
|
||||
|
||||
```bash
|
||||
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-6.0
|
||||
```
|
||||
|
||||
Run the following command to check if everything was installed correctly:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get:
|
||||
|
||||
```
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
If you do not get this output and the installation was not successful, [try other methods](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu#2204).
|
||||
|
||||
If it was successful, you can now install the MCC.
|
||||
|
||||
### Installing MCC on a VPS
|
||||
|
||||
Now that you have .NET Core 6.0 and a user account, you should install the `screen` utility, you will need this in order to keep the MCC running once you close down the SSH session (if you do not have it, the MCC will just stop working once you disconnect). You can look at the `screen` like a window, except it's in a terminal, it lets you have multiple "windows" open at the same time.
|
||||
|
||||
> **ℹ️ NOTE: There is also a Docker method, if you're using Docker, you do not need the `screen` program.**
|
||||
|
||||
You also can learn about the screen command from [this Youtube tutorial](https://youtu.be/_ZJiEX4rmN4).
|
||||
|
||||
To install the `screen` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install screen -y
|
||||
```
|
||||
|
||||
Now you can install the MCC:
|
||||
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)
|
||||
|
||||
How to use the `screen` command?
|
||||
|
||||
> **⚠️ WARNING: If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**
|
||||
|
||||
To start a screen, type:
|
||||
|
||||
```bash
|
||||
screen -S mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**
|
||||
|
||||
> **ℹ️ NOTE: You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**
|
||||
|
||||
Now you will be in the screen, now you can start the MCC and detach from the screen.
|
||||
|
||||
To detach from the screen press `CTRL + A + D`.
|
||||
|
||||
To re-attach/return to the screen, execute the following command:
|
||||
|
||||
```bash
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:
|
||||
|
||||
```bash
|
||||
screen -d mcc
|
||||
```
|
||||
|
||||
To list out screens you can use:
|
||||
|
||||
```bash
|
||||
screen -ls
|
||||
```
|
||||
|
||||
To stop the MCC, you can hit `CTRL + D` (hit it few times).
|
||||
919
docs/ar/guide/usage.md
Normal file
919
docs/ar/guide/usage.md
Normal file
|
|
@ -0,0 +1,919 @@
|
|||
# Usage
|
||||
|
||||
How to run the program:
|
||||
|
||||
- [Running on Windows](#windows)
|
||||
- [Running on Linux, macOS](#linux-macos)
|
||||
- [Running using Docker](#docker)
|
||||
|
||||
Using the command line parameters:
|
||||
|
||||
- [Examples](#quick-usage-of-mcc-with-examples)
|
||||
- [Command line parameters](#command-line-parameters)
|
||||
- [Internal commands](#internal-commands)
|
||||
|
||||
## Windows
|
||||
|
||||
Simply run `MinecraftClient.exe`
|
||||
|
||||
> **ℹ️ NOTE: On Windows it's best using [Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/install) for the best experience and looks. Some features like emojis in the [`/chunk`](#chunk) command do not work in CMD or Powershell 5**
|
||||
|
||||
## Linux, macOS
|
||||
|
||||
To run the client you need to type the following command in your terminal emulator:
|
||||
|
||||
```bash
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
If you want to keep it running in the background you can use `screen` (Linux only) Example:
|
||||
|
||||
```bash
|
||||
# Start the screen
|
||||
screen -S mcc
|
||||
|
||||
# Run it
|
||||
./MinecraftClient
|
||||
|
||||
# Detach from the screen by pressing CTRL + A + D
|
||||
|
||||
# Re-attach if you want to have accces again
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
_Learn more on how to use the screen command: [YouTube](https://www.youtube.com/watch?v=_ZJiEX4rmN4)_
|
||||
|
||||
## Docker
|
||||
|
||||
See [Run using Docker](./guide/installation.md#using-docker)
|
||||
|
||||
## Command-line usage
|
||||
|
||||
**Minecraft Console Client** has a plethora of useful command line parameters, here you can learn about them.
|
||||
|
||||
### For people not familiar with the command line
|
||||
|
||||
For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.
|
||||
|
||||
In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.
|
||||
|
||||
Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:
|
||||
|
||||
- `someparameter`
|
||||
- `-some-parameter`
|
||||
- `--some-other-parameter`
|
||||
- `--some-setting="some value"`
|
||||
- `-a=5`
|
||||
|
||||
Parameters with a single dash (`-`) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (`--`) are being used for parameters with a longer/full name.
|
||||
|
||||
When you are reading examples, you will often see something like this: `<something here>`, this means that this is a place holder and it should be changed with some value, excluding the `<` and the `>`.
|
||||
|
||||
For example `<username>` you need to change to an username of your liking, example: `notch` (`<` and `>` should not be included).
|
||||
|
||||
`[` and `]` mean that a parameter is an optional one.
|
||||
|
||||
They also can hold some values, example from the MCC:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
```
|
||||
|
||||
When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes (`"`), example: `--some-parameter="some text here with spaces in it"`
|
||||
|
||||
Here is an example for using a `--help` command line parameter for MCC that will print out a page on how to use MCC from the command line:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
```
|
||||
|
||||
### Quick usage of MCC with examples
|
||||
|
||||
> **ℹ️ NOTE: On Linux and macOS, you need to type: `./MinecraftClient` instead of `MinecraftClient.exe`**
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
MinecraftClient.exe <username> <password> <server>
|
||||
MinecraftClient.exe <username> <password> <server> "/mycommand"
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
MinecraftClient.exe --section.setting=value [--other settings]
|
||||
MinecraftClient.exe <settings-file.ini> [--other settings]
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
|
||||
MinecraftClient.exe notch password123 mc.someserver.com:25565
|
||||
|
||||
# Overriding a setting from MinecraftClient.ini using a command line parameter
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
|
||||
# Providing a custom settings ini file and overriding a language to Chinese
|
||||
MinecraftClient.exe CustomSettingsFile.ini --language=zh
|
||||
```
|
||||
|
||||
### Rules of using the command line parameters
|
||||
|
||||
You can mix and match arguments by following theses rules:
|
||||
|
||||
- First positional argument may be either the login or a settings file
|
||||
- Other positional arguments are read in order: login, password, server, command
|
||||
- Arguments starting with `--` can be in any order and position
|
||||
|
||||
Examples and further explanations:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server>
|
||||
```
|
||||
|
||||
- This will automatically connect you to the chosen server.
|
||||
- You may omit password and/or server to specify e.g. only the login
|
||||
- To specify a server but ask password interactively, use `""` as password.
|
||||
- To specify offline mode with no password, use `-` as password.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server> "/mycommand"
|
||||
```
|
||||
|
||||
- This will automatically send `/mycommand` to the server and close.
|
||||
- To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini>
|
||||
```
|
||||
|
||||
- This will load the specified configuration file
|
||||
- If the file contains login / password / server ip, it will automatically connect.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
```
|
||||
|
||||
- Specify settings on the command-line, see possible value in the configuration file
|
||||
- Use `--section.setting=value` for settings outside the `[Main]` section
|
||||
- Example: `--antiafk.enabled=true` for enabling the `AntiAFK` bot
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]
|
||||
```
|
||||
|
||||
- Load the specified configuration file and override some settings from the file
|
||||
|
||||
## Internal Commands
|
||||
|
||||
These commands can be performed from the chat prompt, scripts or remote control.
|
||||
|
||||
From chat prompt, commands must by default be prepended with a slash, eg. `/quit`.
|
||||
|
||||
In scripts and remote control, no slash is needed to perform the command, eg. `quit`.
|
||||
|
||||
> **ℹ️ NOTE: Some commands may not be documented yet or are defined in description of Chat Bots, use `/help` to list them all, or you can contribute to this page.**
|
||||
|
||||
### `animation`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Swing your main or off hand.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/animation <mainhand|offhand>
|
||||
```
|
||||
|
||||
### `bed`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to make the bot sleep easily, all about sleeping in one command.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `bed leave|sleep <x> <y> <z>|sleep <radius>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Leave a bed:
|
||||
|
||||
```
|
||||
/bed leave
|
||||
```
|
||||
|
||||
Sleep in a bed on 124 84 76:
|
||||
|
||||
```
|
||||
/bed sleep 124 84 76
|
||||
```
|
||||
|
||||
Sleep in a bed using relative coordinates:
|
||||
|
||||
```
|
||||
/bed sleep ~ ~ ~-2
|
||||
```
|
||||
|
||||
Automatically find a bed in radius of 50 blocks and sleep in it:
|
||||
|
||||
```
|
||||
/bed sleep 50
|
||||
```
|
||||
|
||||
### `bots`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/bots <list|unload <bot name|all>>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Unload a bot called CustomScript
|
||||
|
||||
```
|
||||
/bots unload CustomScript
|
||||
```
|
||||
|
||||
Unload all bots
|
||||
|
||||
```
|
||||
/bots unload all
|
||||
```
|
||||
|
||||
### `changeslot`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Change your selected slot in the hotbar.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/changeslot <1-9>
|
||||
```
|
||||
|
||||
### `chunk`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Displays the chunk loading status in a nice way.
|
||||
|
||||
> **⚠️ WARNING: To use this feature you need to enable the [Terrain and Movements](configuration.md#terrainandmovements)**
|
||||
|
||||
> **ℹ️ NOTE: You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: [`enableemoji`](configuration.md#enableemoji)**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/chunk status [chunkX chunkZ|locationX locationY locationZ]
|
||||
```
|
||||
|
||||
How it looks:
|
||||
|
||||
|
||||
|
||||
### `dig`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Dig a block on a specific coordinate.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dig <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dig 127 63 12
|
||||
```
|
||||
|
||||
Using relative coordinates:
|
||||
|
||||
```
|
||||
/dig ~ ~-1 ~2
|
||||
```
|
||||
|
||||
### `dropitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Drop all items of a specific type from your inventory.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dropitem <itemtype>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All item types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs).**
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dropitem diamond
|
||||
```
|
||||
|
||||
### `entity`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Attack an entity, use an entity or get a list of entities around you.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Entity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/entity <id|entitytype> <attack|use>
|
||||
```
|
||||
|
||||
Get a list of entities around you:
|
||||
|
||||
```
|
||||
/entity
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All entity types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/EntityType.cs).**
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Attack a Zombie:
|
||||
|
||||
```
|
||||
/entity Zombie attack
|
||||
```
|
||||
|
||||
### `execif`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute a command if a specific condition is met.
|
||||
|
||||
The condition is a C# expression and the local variables you set using [`set`](#set), [`setrnd`](#setrnd) or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.
|
||||
|
||||
Also the instance of MCC is available with `MCC.`.
|
||||
|
||||
> **ℹ️ NOTE: All local variables are treated as strings in the app, when comparing their values, you can use `<variable> == "<value>"`, or better use [`.Equals`](https://www.programiz.com/csharp-programming/library/string/equals) method**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `/execif <condition (C# expression)> ---> <command>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Setting a variable and using it:
|
||||
|
||||
```
|
||||
/set test=Something
|
||||
/execif test == "Something" ---> send Success!
|
||||
```
|
||||
|
||||
```
|
||||
/set test2=1
|
||||
/execif test2 == "1" ---> send Success 2!
|
||||
```
|
||||
|
||||
|
||||
Basic C# expression:
|
||||
|
||||
```
|
||||
/execif 1 + 2 + 3 == 6 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using MCC class:
|
||||
|
||||
```
|
||||
/execif MCC.GetHealth() == 20.0 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using in combination with [`execmulti`](#execmulti):
|
||||
|
||||
```
|
||||
/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3
|
||||
```
|
||||
|
||||
### `execmulti`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute multiple commands in succession on a single line, useful for debugging or when using [`execif`](#execif)
|
||||
|
||||
Commands are separated by `->`
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `execmulti <command 1> -> <command 2> -> <command 3> -> ...`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/execmulti send 1 -> send 2 -> send 3 -> sneak
|
||||
```
|
||||
|
||||
### `quit`
|
||||
|
||||
- **Alias:** `exit`
|
||||
- **Description:**
|
||||
|
||||
Disconnect from the server and close the application
|
||||
|
||||
### `reco`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Disconnect and reconnect to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reco [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `reload`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Reloads settings from MinecraftClient.ini and Chat Bots.
|
||||
|
||||
> **ℹ️ NOTE: Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reload
|
||||
```
|
||||
|
||||
### `connect`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Go to the given server and resume the script
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/connect <server> [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<server>` is either a server IP or a server alias defined in servers file, for more info check out [serverlist](configuration.html#serverlist)**
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `script`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Run a script containing a list of commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/script <script name>
|
||||
```
|
||||
|
||||
### `send`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Send a message or a command to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/send <text>
|
||||
```
|
||||
|
||||
### `respawn`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use this to respawn if you are dead (like clicking "respawn" in-game)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/respawn
|
||||
```
|
||||
|
||||
### `log`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Display some text in the console (useful for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/log <text>
|
||||
```
|
||||
|
||||
- Example:
|
||||
|
||||
```
|
||||
/log this is some text
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- **Description:**
|
||||
|
||||
List players logged in to the server (uses tab list info sent by server)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/list
|
||||
```
|
||||
|
||||
### `set`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a value which can be used as `%variable%` in further commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/set <variable>=<value>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/set abc=123
|
||||
```
|
||||
|
||||
### `setrnd`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a `%variable%` randomly to one of the provided values
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/setrnd <variable> string1 "\"string2\" string3"
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/setrnd <variable> -7to10
|
||||
```
|
||||
|
||||
(Set a `%variable%` to a number from -7 to 9)
|
||||
|
||||
### `sneak`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle sneaking.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/Sneak
|
||||
```
|
||||
|
||||
### `tps`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Get the server TPS (Ticks Per Second).
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/tps
|
||||
```
|
||||
|
||||
### `useitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use item in the hand, this can be used to do a right click on items which open menus on servers.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useitem
|
||||
```
|
||||
|
||||
### `useblock`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Place a block from a hand on a specific coordinate or open an inventory:
|
||||
|
||||
- chest/trap chest
|
||||
- furnace
|
||||
- brewing stand
|
||||
- dispenser/dropper
|
||||
- hopper
|
||||
- shulker
|
||||
- loom
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **ℹ️ NOTE: Not all inventories have a GUI representation in an ASCII art format.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useblock <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/useblock 43 72 7
|
||||
```
|
||||
|
||||
### `follow`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Make the bot follow a player.
|
||||
|
||||
> **ℹ️ NOTE: This command is avaliable only with [Follow Player](chat-bots.md#follow-player) Chat Bot enabled.**
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.** > **ℹ️ NOTE: You need to have [Enity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/follow <player name|stop>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/follow milutinke
|
||||
```
|
||||
|
||||
### `wait`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Wait X ticks (10 ticks = ~1 second. Only for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/wait <time>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/wait 20
|
||||
```
|
||||
|
||||
### `move`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for moving when terrain and movements feature is enabled.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Terrain and Movements](configuration.md#terrainandmovements) is currently not supported in `1.4.6 - 1.6`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Enable gravity
|
||||
|
||||
```
|
||||
/move gravity on
|
||||
```
|
||||
|
||||
Move to coordinates:
|
||||
|
||||
```
|
||||
/move 125 72 34
|
||||
```
|
||||
|
||||
Move to a center of a block:
|
||||
|
||||
```
|
||||
/move center
|
||||
```
|
||||
|
||||
### `look`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for looking at direction when terrain and movements is enabled
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/look <x y z|yaw pitch|up|down|east|west|north|south>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/look up
|
||||
```
|
||||
|
||||
```
|
||||
/look east
|
||||
```
|
||||
|
||||
### `inventory`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for inventory manipulation.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.
|
||||
|
||||
Inventory has slots and each one of them has an id.
|
||||
|
||||
> **ℹ️ NOTE: This command DOES NOT physically open a container (eg. chest), for that you need to use [`useblock`](#useblock) command first.**
|
||||
|
||||
An example of player inventory with annotated IDs in ASCII art and a list of items:
|
||||
|
||||
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: player and container can be simplified with p and c accordingly**
|
||||
|
||||
Actions:
|
||||
|
||||
- `click`
|
||||
- `shiftclick`
|
||||
- `drop`
|
||||
|
||||
Show/Preview items in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id>
|
||||
```
|
||||
|
||||
Click/Shift-Click on an item in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: The default click is left click**
|
||||
|
||||
Close an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> close
|
||||
```
|
||||
|
||||
Drop item(s) from an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id> drop <slot id> <number of items|all>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To drop all items from a slot, you can use:** `all`
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive <slot id> <item type> <amount>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete <slot id>
|
||||
```
|
||||
|
||||
Show all available inventories:
|
||||
|
||||
```
|
||||
/inventory inventories
|
||||
```
|
||||
|
||||
Search for an item of specified type in available inventories:
|
||||
|
||||
```
|
||||
/inventory search <item type>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Show player's inventory:
|
||||
|
||||
```
|
||||
/inventory player
|
||||
```
|
||||
|
||||
Show/Preview items in an inventory using an id:
|
||||
|
||||
```
|
||||
/inventory 3
|
||||
```
|
||||
|
||||
Click on an item in player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player click 36
|
||||
```
|
||||
|
||||
Right-Click on an item in slot number/id `4` in an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 click 4 right
|
||||
```
|
||||
|
||||
Close an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 close
|
||||
```
|
||||
|
||||
Drop a single item from a player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player drop 36 1
|
||||
```
|
||||
|
||||
Drop all items from a player's inventory in slot number/id `37`:
|
||||
|
||||
```
|
||||
/inventory player drop 37 all
|
||||
```
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive 36 diamondblock 64
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory in slot number/id `36` when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete 36
|
||||
```
|
||||
|
||||
Search for 10 Slime Blocks in available inventories:
|
||||
|
||||
```
|
||||
/inventory s SlimeBlock 10
|
||||
```
|
||||
|
||||
### `debug`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle debug messages, useful for chatbot developers.
|
||||
|
||||
### `help`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Show commands help.
|
||||
|
||||
> **ℹ️ NOTE: Use "/send /help" for server help**
|
||||
28
docs/ca/README.md
Normal file
28
docs/ca/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
home: true
|
||||
heroImage: /images/MCC_logo_with_edge.png
|
||||
tagline: 'Minecraft Console Client (MCC) is a lightweight open-source Minecraft Java client implemented in C#'
|
||||
actions:
|
||||
-
|
||||
text: Installation
|
||||
link: ./guide/installation.md
|
||||
type: primary
|
||||
-
|
||||
text: Learn More →
|
||||
link: ./guide/
|
||||
type: secondary
|
||||
actionText:
|
||||
actionLink:
|
||||
features:
|
||||
-
|
||||
title: Chat
|
||||
details: Chat with other people on the server
|
||||
-
|
||||
title: Automation
|
||||
details: Create bots to do automated tasks
|
||||
-
|
||||
title: Supported Versions
|
||||
details: 1.4 - 1.19.2
|
||||
footer: Made by MCC Team with ❤️
|
||||
---
|
||||
|
||||
163
docs/ca/guide/README.md
Normal file
163
docs/ca/guide/README.md
Normal file
|
|
@ -0,0 +1,163 @@
|
|||
# Introduction
|
||||
|
||||
- [About](#about)
|
||||
- [Quick Intro (YouTube Videos)](#quick-intro)
|
||||
- [Features](#features)
|
||||
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
||||
- [Getting Help](#getting-help)
|
||||
- [Submitting a bug report or an idea/feature-request](#bugs-ideas-feature-requests)
|
||||
- [Important notes on some features](#notes-on-some-features)
|
||||
- [Credits](#credits)
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source **Minecraft** TUI client for **Java edition** that allows you to connect to any Minecraft Java 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, as well as extensible C# API for creating Bots.
|
||||
|
||||
It was originally made by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
||||
|
||||
## Features
|
||||
|
||||
- Chat
|
||||
|
||||
- Send and receive chat messages
|
||||
- [Log chat history](chat-bots.md#chat-log)
|
||||
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
|
||||
- [Anti AFK](chat-bots.md#anti-afk)
|
||||
- [Auto Relog](chat-bots.md#auto-relog)
|
||||
- [Script Scheduler](chat-bots.md#script-scheduler)
|
||||
- [Remote Control](chat-bots.md#remote-control)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
- [Auto Attack](chat-bots.md#auto-attack)
|
||||
- [Auto Fishing](chat-bots.md#auto-fishing)
|
||||
- [Auto Eat](chat-bots.md#auto-eat)
|
||||
- [Auto Craft](chat-bots.md#auto-craft)
|
||||
- [Mailer Bot](chat-bots.md#mailer)
|
||||
- [Auto Drop](chat-bots.md#auto-drop)
|
||||
- [Replay Mod](chat-bots.md#replay-mod)
|
||||
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
||||
- [Docker Support](installation.md#using-docker)
|
||||
- [Inventory Handling](usage.md#inventory)
|
||||
- [Terrain Traversing](usage.md#move)
|
||||
- Entity Handling
|
||||
|
||||
_NOTE: Some of mentioned features are disabled by default and you will have to turn them on in the configuration file and some may require additional configuration on your part for your specific usage._
|
||||
|
||||
## Why Minecraft Console Client?
|
||||
|
||||
- Easy to use
|
||||
- Helpful community
|
||||
- Open-Source
|
||||
- Fast performance
|
||||
- Cross-Platform
|
||||
- Docker Support
|
||||
- 10 years of continuous development
|
||||
- Active contributors
|
||||
- Widely used
|
||||
|
||||
## Quick Intro
|
||||
|
||||
Don't have time to read through the documentation, we got you, our community has made some simple introduction videos about the **Minecraft Console Client**.
|
||||
|
||||
### The list of the tutorials:
|
||||
|
||||
Installation:
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
Using Commands, Scripts and other features:
|
||||
|
||||
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
||||
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
||||
|
||||
## Getting Help
|
||||
|
||||
MCC has a community that is willing to help, we have a Discussions section in out Git Hub repository.
|
||||
|
||||
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) to access it.
|
||||
|
||||
### Before getting help
|
||||
|
||||
- **Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!**
|
||||
- **Please be kind and patient, respect others as they're the ones using their time to help you**
|
||||
|
||||
## Bugs, Ideas, Feature Requests
|
||||
|
||||
Bug reporting, idea submitting or feature requesting are done in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [Github repository]([here](https://github.com/MCCTeam/Minecraft-Console-Client)).
|
||||
|
||||
Navigate to the Issues section, search for a bug, idea or a feature using the search option here in the documentation and in the `Issues` section on Git Hub before making your own.
|
||||
|
||||
If you haven't found anything similar, go ahead and click on the `New issue` button, then choose what you want to do.
|
||||
|
||||
If you're reporting a bug, please be descriptive as much as possible, try to explain how to re-create the bug, attack screenshots and logs, make sure that you have [`debugmessages`](configuration.me#debugmessages) set to `true` before sending a bug report or taking a screenshot.
|
||||
|
||||
### Before submitting
|
||||
|
||||
- **Please use the search option here or in the `Issues` section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!**
|
||||
- **Please be kind, patient and respect others. Thank you!**
|
||||
|
||||
## Notes on some features
|
||||
|
||||
### Inventory, Terrain and Entity Handling
|
||||
|
||||
Inventory handling is currently not supported in versions: `1.4.6 - 1.9`
|
||||
|
||||
Terrain handling is currently not supported in versions: `1.4.6 - 1.6`
|
||||
|
||||
Entity handling is currently not supported in versions: `1.4.6 - 1.9` (but `1.8` and `1.9` are being worked on, almost at the working state, only `EntityMetadata` packet remains to be fixed)
|
||||
|
||||
There features might not always be implemented in the latest version of the game, since they're often subjected to major changes by Mojang, and we need some time to figure out what has changed and to implement the required changes.
|
||||
|
||||
If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.
|
||||
|
||||
## Credits
|
||||
|
||||
_Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
||||
|
||||
Many features would not have been possible without the help of our talented community:
|
||||
|
||||
**Maintainers**
|
||||
|
||||
ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte
|
||||
|
||||
**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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
||||
|
||||
**Bug Hunters**
|
||||
|
||||
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, 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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
||||
|
||||
**Contributors**
|
||||
|
||||
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
||||
|
||||
**Libraries:**
|
||||
|
||||
Minecraft Console Client also borrows code from the following libraries:
|
||||
|
||||
| Name | Purpose | Author | License |
|
||||
| ----------- | ---------------- | ---------------- | ------- |
|
||||
| Biko | Proxy handling | Benton Stark | MIT |
|
||||
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
||||
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
||||
|
||||
## Disclaimer
|
||||
|
||||
Even if everything should work, we are not responsible for 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 from the source code.
|
||||
|
||||
Also, remember that when you connect to a server with this program, you will appear where you left the last time. This means that **you can die if you log in in an unsafe place on a survival server!** Use the script scheduler bot to send a teleport command after logging in.
|
||||
|
||||
We remind you that **you may get banned** by your server for using this program. Use accordingly with server rules.
|
||||
|
||||
## License
|
||||
|
||||
Minecraft Console Client is a totally free of charge, open source project. The source code is available at [Github Repository](https://github.com/MCCTeam/Minecraft-Console-Client)
|
||||
|
||||
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html) Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|
||||
1921
docs/ca/guide/chat-bots.md
Normal file
1921
docs/ca/guide/chat-bots.md
Normal file
File diff suppressed because it is too large
Load diff
1185
docs/ca/guide/configuration.md
Normal file
1185
docs/ca/guide/configuration.md
Normal file
File diff suppressed because it is too large
Load diff
76
docs/ca/guide/contibuting.md
Normal file
76
docs/ca/guide/contibuting.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# Contributing
|
||||
|
||||
At this moment this page needs to be created.
|
||||
|
||||
For now you can use our article from the [Git Hub repository Wiki](https://github.com/MCCTeam/Minecraft-Console-Client/wiki/Update-console-client-to-new-version) written by [ReinforceZwei](https://github.com/ReinforceZwei).
|
||||
|
||||
## Translations
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* **`en.ini` : English - English**
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
### Add new translation
|
||||
|
||||
1. First you need to get the name of the translated file.
|
||||
* Visit [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) and find the first occurrence of the language you need to translate in the table below.
|
||||
* Use the language code of the row in the table as the name of the translation file.
|
||||
* For example:
|
||||
* `English` -> row `English 0x0009` -> `en` -> `en.ini`
|
||||
* `Chinese (Traditional)` -> row `Chinese (Traditional) 0x7C04` -> `zh-Hant` -> `zh-Hant.ini`
|
||||
|
||||
2. Which system languages are recommended to use this translation?
|
||||
* Still check the table in [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c), one language may have multiple rows.
|
||||
* You will need to indicate which language codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `de.ini` applies to `de`, `de-AT`, `de-BE`, `de-DE`, ...
|
||||
* Translation `zh-Hans.ini` applies to `zh-Hans`, `zh`, `zh-CN`, `zh-SG`.
|
||||
|
||||
3. Which game languages are recommended to use this translation?
|
||||
* Check out the table in [this link](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239), where the `Locale Code` column indicates the language code in minecraft.
|
||||
* You will need to indicate which locale codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `fr.ini` applies to `fr_ca`, `fr_fr`.
|
||||
* Translation `zh-Hans.ini` applies to `zh_cn`.
|
||||
|
||||
4. Add the new translation to the code. (Optional)
|
||||
* **If you are not familiar with programming, you can skip this step and just write the above information in your PR or issue.**
|
||||
* Add the newly created translation file `xx.ini` to the project `/Resources/lang/xx.ini`.
|
||||
* Open `/DefaultConfigResource.resx`.
|
||||
* Click `Add Resources`.
|
||||
* Choose `/Resources/lang/xx.ini`.
|
||||
* Rename the added resource file in `/DefaultConfigResource.resx` to `Translation_xx`.
|
||||
* Open `/Translations.cs`.
|
||||
* Find `public static Tuple<string, string[]> GetTranslationPriority();`
|
||||
* Update the mapping of system language codes to translation files.
|
||||
* Find `public static string[] GetTranslationPriority(string gameLanguage);`
|
||||
* Update the mapping of game locale code to translation files.
|
||||
|
||||
5. Follow the section "Update existing translation".
|
||||
|
||||
### Update existing translation
|
||||
|
||||
1. Visit [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang), download `en.ini` and the language you want to translate(`xx.ini`).
|
||||
|
||||
2. Compare `en.ini` and `xx.ini` and update outdated or non-existent entries in `xx.ini`.
|
||||
|
||||
3. 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.
|
||||
|
||||
### Translate README.md
|
||||
|
||||
1. Get the English version of the README.md from [here](https://raw.githubusercontent.com/MCCTeam/Minecraft-Console-Client/master/README.md).
|
||||
|
||||
2. See `Add new translation -> 1.` for the target language code. Assume it is `xx`.
|
||||
|
||||
3. Complete the translation according to the English README.md and name the translated version as `README-xx.md`.
|
||||
|
||||
4. In the English README, above the "About" section, add the name of the language and a hyperlink to `README-xx.md`.
|
||||
|
||||
## Contributors
|
||||
|
||||
[Check out our contributors on Github](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors).
|
||||
170
docs/ca/guide/creating-bots.md
Normal file
170
docs/ca/guide/creating-bots.md
Normal file
|
|
@ -0,0 +1,170 @@
|
|||
# Creating Chat Bots
|
||||
|
||||
- [Notes](#notes)
|
||||
- [Requirements](#requirements)
|
||||
- [Quick Introduction](#quick-introduction)
|
||||
- [Examples](#examples)
|
||||
- [C# API](#c#-api)
|
||||
|
||||
## Notes
|
||||
|
||||
> **ℹ️ NOTE: For now this page contains only the bare basics of the Chat Bot API, enough of details to teach you how to make basic Chat Bots. For more details you need to take a look at the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) and [Examples](#examples). This page will be improved in the future.**
|
||||
|
||||
**Minecraft Console Client** has a rich C# API which allows you to create Chat Bots (effectively plugins) which can help you create complex automations which normal scripts may not be able to do.
|
||||
|
||||
## Requirements
|
||||
|
||||
- A basic knowledge of C# programming language
|
||||
- A text editor
|
||||
|
||||
If you're not familiar with the C# programming language, we suggest taking a look at the following resources:
|
||||
|
||||
Crash courses:
|
||||
|
||||
- [C# Crash Course playlist by Teddy Smit](https://www.youtube.com/watch?v=67oWw9TanOk&list=PL82C6-O4XrHfoN_Y4MwGvJz5BntiL0z0D)
|
||||
|
||||
More in-depth:
|
||||
|
||||
- [Learn C# Youtube Playlist by Microsoft](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oVxKLQCHpiUWun7vlJJvUiN)
|
||||
- [Getting started with C# (An index of tutorials and the documentation) by Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/)
|
||||
|
||||
## Quick Introduction
|
||||
|
||||
This introduction assumes that you have the basic knowledge of C#.
|
||||
|
||||
> **ℹ️ NOTE: Here we will use terms Chat Bot and Script interchangeably**
|
||||
|
||||
Create a new empty file and name it `ExampleChatBot.cs` in the same folder where you have your MCC installed.
|
||||
|
||||
Paste the following example code:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
|
||||
// The code and comments above are defining a "Script Metadata" section
|
||||
|
||||
// Every single chat bot (script) must be a class which extends the ChatBot class.
|
||||
// Your class must be instantiates in the "Script Metadata" section and passed to MCC.LoadBot function.
|
||||
class ExampleChatBot : ChatBot
|
||||
{
|
||||
// This method will be called when the script has been initialized for the first time, it's called only once
|
||||
// Here you can initialize variables, eg. Dictionaries. etc...
|
||||
public override void Initialize()
|
||||
{
|
||||
LogToConsole("An example Chat Bot has been initialized!");
|
||||
}
|
||||
|
||||
// This is a function that will be run when we get a chat message from a server
|
||||
// In this example it just detects the type of the message and prints it out
|
||||
public override void GetText(string text)
|
||||
{
|
||||
string message = "";
|
||||
string username = "";
|
||||
text = GetVerbatim(text);
|
||||
|
||||
if (IsPrivateMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has sent you a private message: " + message);
|
||||
}
|
||||
else if (IsChatMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has said: " + message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Start MCC, connect to a server and run the following internal command: `/script ExampleChatBot.cs`.
|
||||
|
||||
If you did everything right you should see: `[Example Chat Bot] An example Chat Bot has been initialised!` message appear in your console log.
|
||||
|
||||
### Structure of Chat Bots
|
||||
|
||||
Chat Bot (Script) structure is the following:
|
||||
|
||||
```
|
||||
<script metadata>
|
||||
<chat bot class>
|
||||
```
|
||||
|
||||
**Script Metadata** is a section with a custom format that mixes in C# with our format using comments. Every single Chat Bot (Script) must have this section at the beginning in order to work.
|
||||
|
||||
### Script Metadata Format
|
||||
|
||||
`//MCCScript 1.0` marks the beginning of the **Script Metadata** section, this must always be on the first line or the Chat Bot (Script) will not load and will throw an error.
|
||||
|
||||
`//MCCScript Extensions` marks the end of the **Script Metadata** section, this must be defined before a Chat Bot (Script) class.
|
||||
|
||||
In order for your Chat Bot (Script) to properly load in-between the `//MCCScript 1.0` and the `//MCCScript Extensions` lines you must instantiate your Chat Bot (Script) class and pass it to the `MCC.LoadBot` function.
|
||||
|
||||
Example code:
|
||||
|
||||
```
|
||||
MCC.LoadBot(new YourChatBotClassNameHere());
|
||||
```
|
||||
|
||||
**Script Metadata** section allows for including C# packages and libraries with: `//using <namespace>` and `/dll <dll name>`.
|
||||
|
||||
> **ℹ️ NOTE: Avoid adding whitespace between `//` and keywords**
|
||||
|
||||
By the default the following packages are loaded:
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Text.RegularExpressions;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.IO;
|
||||
using System.Net;
|
||||
using System.Threading;
|
||||
using MinecraftClient;
|
||||
using MinecraftClient.Mapping;
|
||||
using MinecraftClient.Inventory;
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```csharp
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
```
|
||||
|
||||
Full Example:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
```
|
||||
|
||||
### Chat Bot Class
|
||||
|
||||
After the end of the **Script Metadata** section, you basically can define any number of classes you like, the only limitation is that the main class of your Chat Bot (Script) must extend `ChatBot` class.
|
||||
|
||||
There are no required methods, everything is optional.
|
||||
|
||||
When the Chat Bot (Script) has been initialized for the first time the `Initialize` method will be called. In it you can initialize variables, eg. Dictionaries, etc..
|
||||
|
||||
> **ℹ️ NOTE: For allocating resources like a database connection, we recommend allocating them in `AfterGameJoined` and freeing them in `OnDisconnect`**.
|
||||
|
||||
## Examples
|
||||
|
||||
You can find a lot of examples in our Git Hub Repository at [ChatBots](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/ChatBots) and [config](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config).
|
||||
|
||||
## C# API
|
||||
|
||||
As of the time of writing, the C# API has been changed in forks that are yet to be merged, so for now you can use the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) for reference.
|
||||
|
||||
Each method is well documented with standard C# documentation comments.
|
||||
|
||||
In the future we will make a script to auto-generate this section based on the documentation in the code.
|
||||
931
docs/ca/guide/installation.md
Normal file
931
docs/ca/guide/installation.md
Normal file
|
|
@ -0,0 +1,931 @@
|
|||
# Installation
|
||||
|
||||
- [YouTube Tutorials](#youtube-tutorials)
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker)
|
||||
- [Run on Android](#run-on-android)
|
||||
- [Run MCC 24/7 on a VPS](#run-on-a-vps)
|
||||
|
||||
## YouTube Tutorials
|
||||
|
||||
If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
## Download a compiled binary
|
||||
|
||||
In order to run **Minecraft Console Client** you need [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download)
|
||||
|
||||
> **⚠️ IMPORTANT: If you already have .NET, but an older version than `6.0`, please update to `6.0` since MCC might not work as expected or at all.**
|
||||
|
||||
#### How to install .NET on your platform
|
||||
|
||||
- [Install .NET on Windows](https://docs.microsoft.com/en-us/dotnet/core/install/windows)
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Download
|
||||
|
||||
You can download a compiled binary file of the latest build from our Releases section on Git Hub: [Download](https://github.com/MCCTeam/Minecraft-Console-Client/releases)
|
||||
|
||||
## Building from the source code
|
||||
|
||||
### Windows
|
||||
|
||||
Requirements:
|
||||
|
||||
- [Git](https://www.git-scm.com/)
|
||||
- [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
Install [Git](https://www.git-scm.com/)
|
||||
|
||||
1. Make a new folder where you want to keep the source code
|
||||
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
|
||||
3. Click on `Git Bash Here` in the context menu
|
||||
4. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
|
||||
6. Open up the new cloned folder
|
||||
|
||||
#### Building using the Visual Studio
|
||||
|
||||
1. Open up the `MinecraftClient.sln` via Visual Studio
|
||||
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
3. Click on `Properties`
|
||||
4. Open up the `Build` tab and select configuration `Release`
|
||||
5. Press `CTRL + S` and close the file
|
||||
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
7. Click `Build`
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
#### Building using .NET manually without Visual Studio
|
||||
|
||||
1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
|
||||
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
|
||||
3. Run the following command to build the project:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r win-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
### Linux, macOS
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
|
||||
- Linux:
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**
|
||||
|
||||
- [Install Git on macOS](https://git-scm.com/download/mac)
|
||||
|
||||
- .NET SDK 6.0 or new-er
|
||||
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
1. Open up a terminal emulator and navigate to the folder where you will store the MCC
|
||||
2. Recursively clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)
|
||||
4. Run the following command to build the project:
|
||||
|
||||
- On Linux:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r linux-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux that is either ARM, 32-bit, Rhel based, Using Musl, or Tirzen, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace the `'-r linux-64` with an appropriate `-r <your RID>` (Example for arm: `-r linux-arm64`)**
|
||||
|
||||
- On macOS:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r osx-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're not using MAC with Intel, find an appropriate RID for your ARM processor, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) and replace the `'-r osx-64` with an appropriate `-r <your RID>` (Example for arm: `-r osx.12-arm64`)**
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient` will be in:
|
||||
|
||||
- Linux: `MinecraftClient/bin/Release/net6.0/linux-x64/publish/`
|
||||
- macOS: `MinecraftClient/bin/Release/net6.0/osx-x64/publish/`
|
||||
|
||||
## Using Docker
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
- Docker
|
||||
|
||||
> **ℹ️ NOTE: This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**
|
||||
|
||||
> **⚠️ WARNING: Pay attention at warnings, Docker currently works, but you must start the containers in the interactive mode or MCC will crash, we're working on solving this.**
|
||||
|
||||
1. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
2. Navigate to `Minecraft-Console-Client/Docker`
|
||||
3. Build the image using the following command
|
||||
|
||||
```bash
|
||||
docker build -t minecraft-console-client:latest .
|
||||
```
|
||||
|
||||
**Start the container using Docker:**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: There is a bug with the ConsoleInteractive which causes a crash when a container is started in a headless mode, so you need to use the interactive mode. Do not restart containers in a classic way, stop then and start them with interactive mode (this command), after that simply detach with `CTRL + P` and then `CTRL + Q`.**
|
||||
|
||||
```bash
|
||||
# You could also ignore the -v parameter if you dont want to mount the volume that is up to you. If you don't it's harder to edit the .ini file if thats something you want to do
|
||||
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
|
||||
```
|
||||
|
||||
Now you could login and the Client is running. To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`. To reattach use the `docker attach` command.
|
||||
|
||||
**Start the container using docker-compose:**
|
||||
|
||||
By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.
|
||||
|
||||
If you don't want to map a volume, you have to comment out or delete the entire volumes section:
|
||||
|
||||
```yml
|
||||
#volumes:
|
||||
#- './data:/opt/data'
|
||||
```
|
||||
|
||||
Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:
|
||||
|
||||
```bash
|
||||
docker-compose run MCC
|
||||
```
|
||||
|
||||
Remember to remove the container after usage:
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
If you use the INI file and entered your data (username, password, server) there, you can start your container using
|
||||
|
||||
```bash
|
||||
docker-compose up
|
||||
docker-compose up -d #for deamonized running in the background
|
||||
```
|
||||
|
||||
Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`. As above, you can stop and remove the container using
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Run on Android
|
||||
|
||||
It is possible to run the Minecraft Console Client on Android through Termux and Ubuntu 22.04 in it, however it requires a manual setup with a lot of commands, be careful no to skip any steps. Note that this might take anywhere from 10 to 20 minutes or more to do depending on your technical knowledge level, Internet speed and CPU speed.
|
||||
|
||||
> **ℹ️ NOTE: This section is going to get a bit technical, I'll try my best to make everything as simple as possible. If you are having trouble following along or if you encounter any issues, feel free to open up a discussion on our Github repository page.**
|
||||
|
||||
> **ℹ️ NOTE: You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**
|
||||
|
||||
> **ℹ️ NOTE: Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**
|
||||
|
||||
### Installation
|
||||
|
||||
#### Termux
|
||||
|
||||
> **⚠️ IMPORTANT: The Play Store version of Termux is outdated and not supported, do not use it, use the the [Github one](https://github.com/termux/termux-app/releases/latest/).**
|
||||
|
||||
Go to [the Termux Github latest release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it and run it.
|
||||
|
||||
> **ℹ️ NOTE: If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!**
|
||||
|
||||
#### Installing Ubuntu 22.04
|
||||
|
||||
At this stage, you have 2 options:
|
||||
|
||||
1. Following this textual tutorial
|
||||
2. Watching a [Youtube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM)
|
||||
|
||||
> **ℹ️ NOTE: If you decide to watch the Youtube tutorial, watch only up to `1:58`, the steps after are not needed and might just confuse you.**
|
||||
|
||||
In order to install Ubuntu 22.04 in Termux you require `wget` and `proot`, we're going to install them in the next step.
|
||||
|
||||
Once you have Termux installed open it up and run the following command one after other (in order):
|
||||
|
||||
1. `pkg update`
|
||||
2. `pkg upgrade`
|
||||
3. `pkg install proot wget`
|
||||
|
||||
> **ℹ️ NOTE: If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter**
|
||||
|
||||
Then you need to download an installation script using the following command:
|
||||
|
||||
```bash
|
||||
wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh
|
||||
```
|
||||
|
||||
Once the script has downloaded, run it with:
|
||||
|
||||
```bash
|
||||
bash ubuntu.sh
|
||||
```
|
||||
|
||||
Then you will be asked a question, enter `Y` and press `Enter`. Once the installation is complete, you can start Ubuntu with:
|
||||
|
||||
```bash
|
||||
./startubuntu.sh
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command**
|
||||
|
||||
#### Installing .NET on ARM
|
||||
|
||||
Since there are issues installing .NET 6.0 via the APT package manager at the time of writing, we will have to install it manually.
|
||||
|
||||
First we need to update the APT package manager repositories and install dependencies.
|
||||
|
||||
To update the APT repositories, run the following command:
|
||||
|
||||
```bash
|
||||
apt update -y && apt upgrade -y
|
||||
```
|
||||
|
||||
After you did it, we need to install dependencies for .NET, with the following command:
|
||||
|
||||
```bash
|
||||
apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y
|
||||
```
|
||||
|
||||
After you have installed dependencies, it's time to install .NET, you either can follow this tutorial or the [Microsoft one](https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install).
|
||||
|
||||
Navigate to your `/root` home directory with the following command:
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
```
|
||||
|
||||
First you need to download .NET 6.0, you can do it with the following command:
|
||||
|
||||
```bash
|
||||
wget https://download.visualstudio.microsoft.com/download/pr/901f7928-5479-4d32-a9e5-ba66162ca0e4/d00b935ec4dc79a27f5bde00712ed3d7/dotnet-sdk-6.0.400-linux-arm64.tar.gz
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you have 64 bit version of ARM processor, if you happen to have a 32-bit version replace the link in the command above with [this one](https://download.visualstudio.microsoft.com/download/pr/cf567026-a29a-41aa-bc3a-e4e1ad0df480/0925d411e8e09e31ba7a39a3eb0e29af/aspnetcore-runtime-6.0.8-linux-arm.tar.gz)**.
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you're following along and using Ubuntu 22.04, if you're using a different distro, like Alpine, go to [here](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) and copy an appropriate link for your distro.**
|
||||
|
||||
Once the file has been downloaded, you need to run the following commands in order:
|
||||
|
||||
1. `DOTNET_FILE=dotnet-sdk-6.0.400-linux-arm64.tar.gz`
|
||||
|
||||
> **⚠️ IMPORTANT: If you're using a different download link, update the file name in this command to match your version.**
|
||||
|
||||
2. `export DOTNET_ROOT=/root/.dotnet`
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"`
|
||||
4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools`
|
||||
|
||||
Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located.
|
||||
|
||||
> **⚠️ IMPORTANT: You will need a basic knowledge of Nano text editor, if you do not know how to use it, watch this [Youtube video tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A)**
|
||||
|
||||
To enable this, we need to edit our `/root/.bashrc` file with the following command:
|
||||
|
||||
```bash
|
||||
nano /root/.bashrc
|
||||
```
|
||||
|
||||
Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text:
|
||||
|
||||
```bash
|
||||
export DOTNET_ROOT=/root/.dotnet/
|
||||
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
|
||||
```
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter.
|
||||
|
||||
Veryfy that .NET was installed correctly by running:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get a help page:
|
||||
|
||||
```bash
|
||||
root@localhost:~# dotnet
|
||||
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
#### Installing MCC
|
||||
|
||||
Finally, we can install MCC.
|
||||
|
||||
> **⚠️ IMPORTANT: If you have a 32 ARM processor, you need to build the MCC yourself, take a look at the [Building From Source](#building-from-the-source-code) section. Also make sure to be using the appropriate `-r` parameter value for your architecture.**
|
||||
|
||||
Let's make a folder where the MCC will be stored with the following command:
|
||||
|
||||
```bash
|
||||
mkdir MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Then enter it the newly created folder:
|
||||
|
||||
```bash
|
||||
cd MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Download the MCC with the following command:
|
||||
|
||||
```bash
|
||||
wget https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest/download/MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
Unzip it with the following command:
|
||||
|
||||
```bash
|
||||
unzip MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
You can remove the zip archive now, we do not need it anymore, with:
|
||||
|
||||
```bash
|
||||
rm MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
And finally run it with:
|
||||
|
||||
```
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
#### After installation
|
||||
|
||||
When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh`
|
||||
|
||||
Then you can start the MCC again with `./MinecraftClient`
|
||||
|
||||
To stop MCC from running you can press `CTRL + C`
|
||||
|
||||
To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use, if you have followed the installation steps above, you should be familiar with it, if not, check out [this tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).
|
||||
|
||||
For downloading files, you can use the `wget` file we have installed, simply run: `wget your_link_here` (you have examples above, and a video tutorial down bellow).
|
||||
|
||||
Also, here are some linux tutorials for people who are new to it:
|
||||
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
## Run on a VPS
|
||||
|
||||
> **ℹ️ NOTE: This is a new section, if you find a mistake, please report it by opening an Issue in our [Github repository](https://github.com/MCCTeam/Minecraft-Console-Client). Thank you!**
|
||||
|
||||
The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.
|
||||
|
||||
- [What is a VPS?](#what-is-a-vps)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Where to get a VPS](#where-to-get-a-vps)
|
||||
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
|
||||
- [Initial VPS setup](#initial-vps-setup)
|
||||
- [Creating a new user account](#creating-a-new-user)
|
||||
- [Installing .NET Core 6](#installing-net-core-6)
|
||||
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)
|
||||
|
||||
### What is a VPS?
|
||||
|
||||
VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).
|
||||
|
||||
You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.
|
||||
|
||||
Here is a [Youtube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you're interested.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. Gitbash (if you're on Windows)
|
||||
|
||||
Download and install [Gitbash](https://git-scm.com/downloads).
|
||||
|
||||
> **ℹ️ NOTE: Make sure to allow the installation to add it to the context menu**
|
||||
|
||||
2. `ssh` and `ssh-keygen` commands (On Windows they're available with Gitbash, on macOs and Linux they should be available by default, it not, search on how to install them)
|
||||
|
||||
3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.
|
||||
|
||||
If you already know this, feel free to skip.
|
||||
|
||||
if you get stuck, watch those tutorials.
|
||||
|
||||
If you're new to this, you can learn about it here:
|
||||
|
||||
- [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
### Where to get a VPS
|
||||
|
||||
You have 2 options:
|
||||
|
||||
- [Buying a VPS](#buying-a-vps)
|
||||
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)
|
||||
|
||||
#### Buying a VPS
|
||||
|
||||
If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.
|
||||
|
||||
**What hardware requirements I need for running the MCC?**
|
||||
|
||||
The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.
|
||||
|
||||
**Where to buy a VPS?**
|
||||
|
||||
> **⚠️ VERY IMPORTANT: In this tutorial we will be using `Ubuntu 22.04`, make sure to select it as the OS when buying a VPS.**
|
||||
|
||||
Some of the reliable and cheap hosting providers (sorted for price/performance):
|
||||
|
||||
- [E-Trail](https://e-trail.net/vps)
|
||||
|
||||
**Minimum price**: `2.50 EUR / month`
|
||||
|
||||
> **ℹ️ NOTE: Does not have Ubuntu 22.04 in the dropdown menu when ordering, you will have to re-install later or ask support to do it.**
|
||||
|
||||
- [OVH Cloud](https://www.ovhcloud.com/de/vps/)
|
||||
|
||||
**Minimum price**: `3.57 EUR / month`
|
||||
|
||||
- [Hetzner Cloud](https://www.hetzner.com/cloud)
|
||||
|
||||
**Minimum price**: `4.51 EUR / month`
|
||||
|
||||
- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)
|
||||
|
||||
**Minimum price**: `4 EUR / month`
|
||||
|
||||
- [Contabo](https://contabo.com/en/vps/)
|
||||
|
||||
**Minimum price**: `7 EUR / month`
|
||||
|
||||
**More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**
|
||||
|
||||
You also may want to search for better deals.
|
||||
|
||||
#### AWS EC2 VPS
|
||||
|
||||
> **⚠️ VERY IMPORTANT: This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**
|
||||
|
||||
> **⚠️ WARNING: Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**
|
||||
|
||||
> **⚠️ WARNING: Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**
|
||||
|
||||
> **ℹ️ NOTE: If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**
|
||||
|
||||
Register on AWS and enter all of your billing info and a phone number. Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).
|
||||
|
||||
### Initial Amazon VPS setup
|
||||
|
||||
> **ℹ️ NOTE: Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**
|
||||
|
||||
When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`
|
||||
|
||||
> **ℹ️ NOTE: Make sure to select the region closest to you for the minimal latency**
|
||||
|
||||
Click on the **Launch instance** button.
|
||||
|
||||
Fill out the `Name` field with a name of your preference.
|
||||
|
||||
|
||||
|
||||
For the **Application and OS images** select `Ubuntu Server 22.04 LTS (HVM), SSD Volume Type`.
|
||||
|
||||
> **⚠️ VERY IMPORTANT: Make sure that it has `Free tier eligible` next to it.**
|
||||
|
||||
|
||||
|
||||
For the **Instance type** select `t2.micro`.
|
||||
|
||||
For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.
|
||||
|
||||
> **⚠️ EXTREMELY IMPORTANT: Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**
|
||||
|
||||
|
||||
|
||||
For the **Network settings** check the following checkboxes on:
|
||||
|
||||
- `Allow SSH traffic from` (Anywhere)
|
||||
- `Allow HTTPs traffic from the internet`
|
||||
- `Allow HTTP traffic from the internet`
|
||||
|
||||
> **ℹ️ NOTE: The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**
|
||||
|
||||
|
||||
|
||||
For the **Storage** enter `30`.
|
||||
|
||||
|
||||
|
||||
Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.
|
||||
|
||||
Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.
|
||||
|
||||
You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
In order to login with SSH, you are going to use the following command:
|
||||
|
||||
```bash
|
||||
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<` and `>` are not typed, that is just a notation for a placeholder!**
|
||||
|
||||
> **ℹ️ NOTE: `ubuntu` is a default root account username for Ubuntu on AWS!**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
|
||||
```
|
||||
|
||||
If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.
|
||||
|
||||
Now you can continue to [Creating a new user](#creating-a-new-user)
|
||||
|
||||
### Initial VPS setup
|
||||
|
||||
> **ℹ️ NOTE: This section if for those who do not use AWS, if you use AWS skip it**
|
||||
|
||||
When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.
|
||||
|
||||
Other option is that you will get your login info in the email once the setup is done.
|
||||
|
||||
Once you have the root login account info, you need [Gitbash](https://git-scm.com/downloads) on Windows and `ssh` if you're on macOS or Linux (if you do not have it by some chance, search on how to install it, it is simple).
|
||||
|
||||
If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:
|
||||
|
||||
```bash
|
||||
ssh <username>@<ip>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh root@142.26.73.14
|
||||
```
|
||||
|
||||
Example with port:
|
||||
|
||||
```bash
|
||||
ssh -p 2233 root@142.26.73.14
|
||||
```
|
||||
|
||||
Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.
|
||||
|
||||
### Creating a new user
|
||||
|
||||
Once you've logged in to your VPS you need to create a new user and give it SSH access.
|
||||
|
||||
In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.
|
||||
|
||||
> **ℹ️ NOTE: You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**
|
||||
|
||||
To create a new user named `mcc` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo useradd mcc -m
|
||||
```
|
||||
|
||||
Now we need to give it a password, execute the following command, type the password and confirm it:
|
||||
|
||||
```bash
|
||||
sudo passwd mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: When you're typing a password it will not be displayed on the screen, but you're typing it for real.**
|
||||
|
||||
> **ℹ️ NOTE: Make sure you have a strong password!**
|
||||
|
||||
Now we need to give our user account the admin permissions:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG sudo mcc
|
||||
```
|
||||
|
||||
Now we are going to set it's shell to bash:
|
||||
|
||||
```bash
|
||||
sudo chsh mcc -s /bin/bash
|
||||
```
|
||||
|
||||
Now we need to log in as the `mcc` user:
|
||||
|
||||
```bash
|
||||
su mcc
|
||||
```
|
||||
|
||||
Fill in your password when asked.
|
||||
|
||||
Navigate to the `mcc` user home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Make a new `.ssh` directory:
|
||||
|
||||
```bash
|
||||
mkdir .ssh
|
||||
```
|
||||
|
||||
Enter it with:
|
||||
|
||||
```bash
|
||||
cd .ssh
|
||||
```
|
||||
|
||||
Make a new empty file named `authorized_keys`:
|
||||
|
||||
```bash
|
||||
touch authorized_keys
|
||||
```
|
||||
|
||||
Do no close the Git bash/Terminal emulator. On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account. Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
Type the following command:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t RSA -b 4096
|
||||
```
|
||||
|
||||
Enter the name of the key file to be: `MCC_Key`, press Enter.
|
||||
|
||||
When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.
|
||||
|
||||
This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.
|
||||
|
||||
Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.
|
||||
|
||||
Return to the Git Bash/Terminal emulator and execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install nano -y
|
||||
```
|
||||
|
||||
This will install the Nano editor on your VPS.
|
||||
|
||||
Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.
|
||||
|
||||
Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:
|
||||
|
||||
```bash
|
||||
pwd
|
||||
```
|
||||
|
||||
If it does not print `/home/mcc/.ssh`, navigate to it with:
|
||||
|
||||
```bash
|
||||
cd /home/mcc/.ssh
|
||||
```
|
||||
|
||||
Now you need to open the `authorized_keys` file with the nano editor:
|
||||
|
||||
```bash
|
||||
nano authorized_keys
|
||||
```
|
||||
|
||||
Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.
|
||||
|
||||
Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.
|
||||
|
||||
Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:
|
||||
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
```
|
||||
|
||||
Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.
|
||||
|
||||
Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.
|
||||
|
||||
Additionally for better security you can do the following:
|
||||
|
||||
- Set `PermitRootLogin` to `yes`
|
||||
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
|
||||
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)
|
||||
|
||||
Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.
|
||||
|
||||
Now we need to restart the SSHD service with:
|
||||
|
||||
```bash
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
Let's check if everything is working correctly:
|
||||
|
||||
```bash
|
||||
sudo systemctl status sshd
|
||||
```
|
||||
|
||||
If everything has been configured as it should be you should see `active (running)` as a status of the service. If not, open the config file again and check for mistakes.
|
||||
|
||||
Press `q` to exit the log mode.
|
||||
|
||||
Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.
|
||||
|
||||
Now we can login to the user with our private `MCC_Key` file.
|
||||
|
||||
Command:
|
||||
|
||||
```bash
|
||||
ssh -i <path to the MCC_Key private key> mcc@<ip here>
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i MCC_Key mcc@3.71.108.69
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**
|
||||
|
||||
If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.
|
||||
|
||||
You can do `whoami` to see your username.
|
||||
|
||||
Now you can install .NET Core 6 and MCC.
|
||||
|
||||
### Installing .NET Core 6
|
||||
|
||||
> **ℹ️ NOTE: If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**
|
||||
|
||||
> **⚠️ WARNING: With newer versions of .NET Core 6 on Ubuntu 22.04 you might get the following error: `A fatal error occurred, the folder [/usr/share/dotnet/host/fxr] does not contain any version-numbered child folders`, if you get it, use [this solution](https://github.com/dotnet/sdk/issues/27082#issuecomment-1211143446)**
|
||||
|
||||
Log in as the user you've created.
|
||||
|
||||
Update the system packages and package manager repositories:
|
||||
|
||||
```bash
|
||||
sudo apt update -y && sudo apt upgrade -y
|
||||
```
|
||||
|
||||
Install `wget`:
|
||||
|
||||
```bash
|
||||
sudo apt install wget -y
|
||||
```
|
||||
|
||||
Go to your home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Download the Microsoft repository file:
|
||||
|
||||
```bash
|
||||
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Add Microsoft repositories to the package manager:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Remove the file, we do not need it anymore:
|
||||
|
||||
```bash
|
||||
rm packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Finally, install .NET Core 6:
|
||||
|
||||
```bash
|
||||
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-6.0
|
||||
```
|
||||
|
||||
Run the following command to check if everything was installed correctly:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get:
|
||||
|
||||
```
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
If you do not get this output and the installation was not successful, [try other methods](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu#2204).
|
||||
|
||||
If it was successful, you can now install the MCC.
|
||||
|
||||
### Installing MCC on a VPS
|
||||
|
||||
Now that you have .NET Core 6.0 and a user account, you should install the `screen` utility, you will need this in order to keep the MCC running once you close down the SSH session (if you do not have it, the MCC will just stop working once you disconnect). You can look at the `screen` like a window, except it's in a terminal, it lets you have multiple "windows" open at the same time.
|
||||
|
||||
> **ℹ️ NOTE: There is also a Docker method, if you're using Docker, you do not need the `screen` program.**
|
||||
|
||||
You also can learn about the screen command from [this Youtube tutorial](https://youtu.be/_ZJiEX4rmN4).
|
||||
|
||||
To install the `screen` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install screen -y
|
||||
```
|
||||
|
||||
Now you can install the MCC:
|
||||
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)
|
||||
|
||||
How to use the `screen` command?
|
||||
|
||||
> **⚠️ WARNING: If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**
|
||||
|
||||
To start a screen, type:
|
||||
|
||||
```bash
|
||||
screen -S mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**
|
||||
|
||||
> **ℹ️ NOTE: You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**
|
||||
|
||||
Now you will be in the screen, now you can start the MCC and detach from the screen.
|
||||
|
||||
To detach from the screen press `CTRL + A + D`.
|
||||
|
||||
To re-attach/return to the screen, execute the following command:
|
||||
|
||||
```bash
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:
|
||||
|
||||
```bash
|
||||
screen -d mcc
|
||||
```
|
||||
|
||||
To list out screens you can use:
|
||||
|
||||
```bash
|
||||
screen -ls
|
||||
```
|
||||
|
||||
To stop the MCC, you can hit `CTRL + D` (hit it few times).
|
||||
919
docs/ca/guide/usage.md
Normal file
919
docs/ca/guide/usage.md
Normal file
|
|
@ -0,0 +1,919 @@
|
|||
# Usage
|
||||
|
||||
How to run the program:
|
||||
|
||||
- [Running on Windows](#windows)
|
||||
- [Running on Linux, macOS](#linux-macos)
|
||||
- [Running using Docker](#docker)
|
||||
|
||||
Using the command line parameters:
|
||||
|
||||
- [Examples](#quick-usage-of-mcc-with-examples)
|
||||
- [Command line parameters](#command-line-parameters)
|
||||
- [Internal commands](#internal-commands)
|
||||
|
||||
## Windows
|
||||
|
||||
Simply run `MinecraftClient.exe`
|
||||
|
||||
> **ℹ️ NOTE: On Windows it's best using [Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/install) for the best experience and looks. Some features like emojis in the [`/chunk`](#chunk) command do not work in CMD or Powershell 5**
|
||||
|
||||
## Linux, macOS
|
||||
|
||||
To run the client you need to type the following command in your terminal emulator:
|
||||
|
||||
```bash
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
If you want to keep it running in the background you can use `screen` (Linux only) Example:
|
||||
|
||||
```bash
|
||||
# Start the screen
|
||||
screen -S mcc
|
||||
|
||||
# Run it
|
||||
./MinecraftClient
|
||||
|
||||
# Detach from the screen by pressing CTRL + A + D
|
||||
|
||||
# Re-attach if you want to have accces again
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
_Learn more on how to use the screen command: [YouTube](https://www.youtube.com/watch?v=_ZJiEX4rmN4)_
|
||||
|
||||
## Docker
|
||||
|
||||
See [Run using Docker](./guide/installation.md#using-docker)
|
||||
|
||||
## Command-line usage
|
||||
|
||||
**Minecraft Console Client** has a plethora of useful command line parameters, here you can learn about them.
|
||||
|
||||
### For people not familiar with the command line
|
||||
|
||||
For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.
|
||||
|
||||
In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.
|
||||
|
||||
Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:
|
||||
|
||||
- `someparameter`
|
||||
- `-some-parameter`
|
||||
- `--some-other-parameter`
|
||||
- `--some-setting="some value"`
|
||||
- `-a=5`
|
||||
|
||||
Parameters with a single dash (`-`) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (`--`) are being used for parameters with a longer/full name.
|
||||
|
||||
When you are reading examples, you will often see something like this: `<something here>`, this means that this is a place holder and it should be changed with some value, excluding the `<` and the `>`.
|
||||
|
||||
For example `<username>` you need to change to an username of your liking, example: `notch` (`<` and `>` should not be included).
|
||||
|
||||
`[` and `]` mean that a parameter is an optional one.
|
||||
|
||||
They also can hold some values, example from the MCC:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
```
|
||||
|
||||
When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes (`"`), example: `--some-parameter="some text here with spaces in it"`
|
||||
|
||||
Here is an example for using a `--help` command line parameter for MCC that will print out a page on how to use MCC from the command line:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
```
|
||||
|
||||
### Quick usage of MCC with examples
|
||||
|
||||
> **ℹ️ NOTE: On Linux and macOS, you need to type: `./MinecraftClient` instead of `MinecraftClient.exe`**
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
MinecraftClient.exe <username> <password> <server>
|
||||
MinecraftClient.exe <username> <password> <server> "/mycommand"
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
MinecraftClient.exe --section.setting=value [--other settings]
|
||||
MinecraftClient.exe <settings-file.ini> [--other settings]
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
|
||||
MinecraftClient.exe notch password123 mc.someserver.com:25565
|
||||
|
||||
# Overriding a setting from MinecraftClient.ini using a command line parameter
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
|
||||
# Providing a custom settings ini file and overriding a language to Chinese
|
||||
MinecraftClient.exe CustomSettingsFile.ini --language=zh
|
||||
```
|
||||
|
||||
### Rules of using the command line parameters
|
||||
|
||||
You can mix and match arguments by following theses rules:
|
||||
|
||||
- First positional argument may be either the login or a settings file
|
||||
- Other positional arguments are read in order: login, password, server, command
|
||||
- Arguments starting with `--` can be in any order and position
|
||||
|
||||
Examples and further explanations:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server>
|
||||
```
|
||||
|
||||
- This will automatically connect you to the chosen server.
|
||||
- You may omit password and/or server to specify e.g. only the login
|
||||
- To specify a server but ask password interactively, use `""` as password.
|
||||
- To specify offline mode with no password, use `-` as password.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server> "/mycommand"
|
||||
```
|
||||
|
||||
- This will automatically send `/mycommand` to the server and close.
|
||||
- To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini>
|
||||
```
|
||||
|
||||
- This will load the specified configuration file
|
||||
- If the file contains login / password / server ip, it will automatically connect.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
```
|
||||
|
||||
- Specify settings on the command-line, see possible value in the configuration file
|
||||
- Use `--section.setting=value` for settings outside the `[Main]` section
|
||||
- Example: `--antiafk.enabled=true` for enabling the `AntiAFK` bot
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]
|
||||
```
|
||||
|
||||
- Load the specified configuration file and override some settings from the file
|
||||
|
||||
## Internal Commands
|
||||
|
||||
These commands can be performed from the chat prompt, scripts or remote control.
|
||||
|
||||
From chat prompt, commands must by default be prepended with a slash, eg. `/quit`.
|
||||
|
||||
In scripts and remote control, no slash is needed to perform the command, eg. `quit`.
|
||||
|
||||
> **ℹ️ NOTE: Some commands may not be documented yet or are defined in description of Chat Bots, use `/help` to list them all, or you can contribute to this page.**
|
||||
|
||||
### `animation`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Swing your main or off hand.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/animation <mainhand|offhand>
|
||||
```
|
||||
|
||||
### `bed`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to make the bot sleep easily, all about sleeping in one command.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `bed leave|sleep <x> <y> <z>|sleep <radius>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Leave a bed:
|
||||
|
||||
```
|
||||
/bed leave
|
||||
```
|
||||
|
||||
Sleep in a bed on 124 84 76:
|
||||
|
||||
```
|
||||
/bed sleep 124 84 76
|
||||
```
|
||||
|
||||
Sleep in a bed using relative coordinates:
|
||||
|
||||
```
|
||||
/bed sleep ~ ~ ~-2
|
||||
```
|
||||
|
||||
Automatically find a bed in radius of 50 blocks and sleep in it:
|
||||
|
||||
```
|
||||
/bed sleep 50
|
||||
```
|
||||
|
||||
### `bots`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/bots <list|unload <bot name|all>>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Unload a bot called CustomScript
|
||||
|
||||
```
|
||||
/bots unload CustomScript
|
||||
```
|
||||
|
||||
Unload all bots
|
||||
|
||||
```
|
||||
/bots unload all
|
||||
```
|
||||
|
||||
### `changeslot`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Change your selected slot in the hotbar.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/changeslot <1-9>
|
||||
```
|
||||
|
||||
### `chunk`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Displays the chunk loading status in a nice way.
|
||||
|
||||
> **⚠️ WARNING: To use this feature you need to enable the [Terrain and Movements](configuration.md#terrainandmovements)**
|
||||
|
||||
> **ℹ️ NOTE: You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: [`enableemoji`](configuration.md#enableemoji)**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/chunk status [chunkX chunkZ|locationX locationY locationZ]
|
||||
```
|
||||
|
||||
How it looks:
|
||||
|
||||
|
||||
|
||||
### `dig`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Dig a block on a specific coordinate.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dig <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dig 127 63 12
|
||||
```
|
||||
|
||||
Using relative coordinates:
|
||||
|
||||
```
|
||||
/dig ~ ~-1 ~2
|
||||
```
|
||||
|
||||
### `dropitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Drop all items of a specific type from your inventory.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dropitem <itemtype>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All item types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs).**
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dropitem diamond
|
||||
```
|
||||
|
||||
### `entity`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Attack an entity, use an entity or get a list of entities around you.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Entity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/entity <id|entitytype> <attack|use>
|
||||
```
|
||||
|
||||
Get a list of entities around you:
|
||||
|
||||
```
|
||||
/entity
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All entity types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/EntityType.cs).**
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Attack a Zombie:
|
||||
|
||||
```
|
||||
/entity Zombie attack
|
||||
```
|
||||
|
||||
### `execif`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute a command if a specific condition is met.
|
||||
|
||||
The condition is a C# expression and the local variables you set using [`set`](#set), [`setrnd`](#setrnd) or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.
|
||||
|
||||
Also the instance of MCC is available with `MCC.`.
|
||||
|
||||
> **ℹ️ NOTE: All local variables are treated as strings in the app, when comparing their values, you can use `<variable> == "<value>"`, or better use [`.Equals`](https://www.programiz.com/csharp-programming/library/string/equals) method**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `/execif <condition (C# expression)> ---> <command>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Setting a variable and using it:
|
||||
|
||||
```
|
||||
/set test=Something
|
||||
/execif test == "Something" ---> send Success!
|
||||
```
|
||||
|
||||
```
|
||||
/set test2=1
|
||||
/execif test2 == "1" ---> send Success 2!
|
||||
```
|
||||
|
||||
|
||||
Basic C# expression:
|
||||
|
||||
```
|
||||
/execif 1 + 2 + 3 == 6 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using MCC class:
|
||||
|
||||
```
|
||||
/execif MCC.GetHealth() == 20.0 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using in combination with [`execmulti`](#execmulti):
|
||||
|
||||
```
|
||||
/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3
|
||||
```
|
||||
|
||||
### `execmulti`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute multiple commands in succession on a single line, useful for debugging or when using [`execif`](#execif)
|
||||
|
||||
Commands are separated by `->`
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `execmulti <command 1> -> <command 2> -> <command 3> -> ...`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/execmulti send 1 -> send 2 -> send 3 -> sneak
|
||||
```
|
||||
|
||||
### `quit`
|
||||
|
||||
- **Alias:** `exit`
|
||||
- **Description:**
|
||||
|
||||
Disconnect from the server and close the application
|
||||
|
||||
### `reco`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Disconnect and reconnect to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reco [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `reload`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Reloads settings from MinecraftClient.ini and Chat Bots.
|
||||
|
||||
> **ℹ️ NOTE: Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reload
|
||||
```
|
||||
|
||||
### `connect`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Go to the given server and resume the script
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/connect <server> [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<server>` is either a server IP or a server alias defined in servers file, for more info check out [serverlist](configuration.html#serverlist)**
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `script`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Run a script containing a list of commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/script <script name>
|
||||
```
|
||||
|
||||
### `send`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Send a message or a command to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/send <text>
|
||||
```
|
||||
|
||||
### `respawn`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use this to respawn if you are dead (like clicking "respawn" in-game)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/respawn
|
||||
```
|
||||
|
||||
### `log`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Display some text in the console (useful for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/log <text>
|
||||
```
|
||||
|
||||
- Example:
|
||||
|
||||
```
|
||||
/log this is some text
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- **Description:**
|
||||
|
||||
List players logged in to the server (uses tab list info sent by server)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/list
|
||||
```
|
||||
|
||||
### `set`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a value which can be used as `%variable%` in further commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/set <variable>=<value>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/set abc=123
|
||||
```
|
||||
|
||||
### `setrnd`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a `%variable%` randomly to one of the provided values
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/setrnd <variable> string1 "\"string2\" string3"
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/setrnd <variable> -7to10
|
||||
```
|
||||
|
||||
(Set a `%variable%` to a number from -7 to 9)
|
||||
|
||||
### `sneak`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle sneaking.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/Sneak
|
||||
```
|
||||
|
||||
### `tps`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Get the server TPS (Ticks Per Second).
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/tps
|
||||
```
|
||||
|
||||
### `useitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use item in the hand, this can be used to do a right click on items which open menus on servers.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useitem
|
||||
```
|
||||
|
||||
### `useblock`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Place a block from a hand on a specific coordinate or open an inventory:
|
||||
|
||||
- chest/trap chest
|
||||
- furnace
|
||||
- brewing stand
|
||||
- dispenser/dropper
|
||||
- hopper
|
||||
- shulker
|
||||
- loom
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **ℹ️ NOTE: Not all inventories have a GUI representation in an ASCII art format.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useblock <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/useblock 43 72 7
|
||||
```
|
||||
|
||||
### `follow`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Make the bot follow a player.
|
||||
|
||||
> **ℹ️ NOTE: This command is avaliable only with [Follow Player](chat-bots.md#follow-player) Chat Bot enabled.**
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.** > **ℹ️ NOTE: You need to have [Enity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/follow <player name|stop>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/follow milutinke
|
||||
```
|
||||
|
||||
### `wait`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Wait X ticks (10 ticks = ~1 second. Only for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/wait <time>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/wait 20
|
||||
```
|
||||
|
||||
### `move`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for moving when terrain and movements feature is enabled.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Terrain and Movements](configuration.md#terrainandmovements) is currently not supported in `1.4.6 - 1.6`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Enable gravity
|
||||
|
||||
```
|
||||
/move gravity on
|
||||
```
|
||||
|
||||
Move to coordinates:
|
||||
|
||||
```
|
||||
/move 125 72 34
|
||||
```
|
||||
|
||||
Move to a center of a block:
|
||||
|
||||
```
|
||||
/move center
|
||||
```
|
||||
|
||||
### `look`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for looking at direction when terrain and movements is enabled
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/look <x y z|yaw pitch|up|down|east|west|north|south>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/look up
|
||||
```
|
||||
|
||||
```
|
||||
/look east
|
||||
```
|
||||
|
||||
### `inventory`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for inventory manipulation.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.
|
||||
|
||||
Inventory has slots and each one of them has an id.
|
||||
|
||||
> **ℹ️ NOTE: This command DOES NOT physically open a container (eg. chest), for that you need to use [`useblock`](#useblock) command first.**
|
||||
|
||||
An example of player inventory with annotated IDs in ASCII art and a list of items:
|
||||
|
||||
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: player and container can be simplified with p and c accordingly**
|
||||
|
||||
Actions:
|
||||
|
||||
- `click`
|
||||
- `shiftclick`
|
||||
- `drop`
|
||||
|
||||
Show/Preview items in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id>
|
||||
```
|
||||
|
||||
Click/Shift-Click on an item in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: The default click is left click**
|
||||
|
||||
Close an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> close
|
||||
```
|
||||
|
||||
Drop item(s) from an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id> drop <slot id> <number of items|all>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To drop all items from a slot, you can use:** `all`
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive <slot id> <item type> <amount>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete <slot id>
|
||||
```
|
||||
|
||||
Show all available inventories:
|
||||
|
||||
```
|
||||
/inventory inventories
|
||||
```
|
||||
|
||||
Search for an item of specified type in available inventories:
|
||||
|
||||
```
|
||||
/inventory search <item type>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Show player's inventory:
|
||||
|
||||
```
|
||||
/inventory player
|
||||
```
|
||||
|
||||
Show/Preview items in an inventory using an id:
|
||||
|
||||
```
|
||||
/inventory 3
|
||||
```
|
||||
|
||||
Click on an item in player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player click 36
|
||||
```
|
||||
|
||||
Right-Click on an item in slot number/id `4` in an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 click 4 right
|
||||
```
|
||||
|
||||
Close an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 close
|
||||
```
|
||||
|
||||
Drop a single item from a player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player drop 36 1
|
||||
```
|
||||
|
||||
Drop all items from a player's inventory in slot number/id `37`:
|
||||
|
||||
```
|
||||
/inventory player drop 37 all
|
||||
```
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive 36 diamondblock 64
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory in slot number/id `36` when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete 36
|
||||
```
|
||||
|
||||
Search for 10 Slime Blocks in available inventories:
|
||||
|
||||
```
|
||||
/inventory s SlimeBlock 10
|
||||
```
|
||||
|
||||
### `debug`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle debug messages, useful for chatbot developers.
|
||||
|
||||
### `help`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Show commands help.
|
||||
|
||||
> **ℹ️ NOTE: Use "/send /help" for server help**
|
||||
28
docs/cs/README.md
Normal file
28
docs/cs/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
home: true
|
||||
heroImage: /images/MCC_logo_with_edge.png
|
||||
tagline: 'Minecraft Console Client (MCC) is a lightweight open-source Minecraft Java client implemented in C#'
|
||||
actions:
|
||||
-
|
||||
text: Installation
|
||||
link: ./guide/installation.md
|
||||
type: primary
|
||||
-
|
||||
text: Learn More →
|
||||
link: ./guide/
|
||||
type: secondary
|
||||
actionText:
|
||||
actionLink:
|
||||
features:
|
||||
-
|
||||
title: Chat
|
||||
details: Chat with other people on the server
|
||||
-
|
||||
title: Automation
|
||||
details: Create bots to do automated tasks
|
||||
-
|
||||
title: Supported Versions
|
||||
details: 1.4 - 1.19.2
|
||||
footer: Made by MCC Team with ❤️
|
||||
---
|
||||
|
||||
163
docs/cs/guide/README.md
Normal file
163
docs/cs/guide/README.md
Normal file
|
|
@ -0,0 +1,163 @@
|
|||
# Introduction
|
||||
|
||||
- [About](#about)
|
||||
- [Quick Intro (YouTube Videos)](#quick-intro)
|
||||
- [Features](#features)
|
||||
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
||||
- [Getting Help](#getting-help)
|
||||
- [Submitting a bug report or an idea/feature-request](#bugs-ideas-feature-requests)
|
||||
- [Important notes on some features](#notes-on-some-features)
|
||||
- [Credits](#credits)
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source **Minecraft** TUI client for **Java edition** that allows you to connect to any Minecraft Java 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, as well as extensible C# API for creating Bots.
|
||||
|
||||
It was originally made by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
||||
|
||||
## Features
|
||||
|
||||
- Chat
|
||||
|
||||
- Send and receive chat messages
|
||||
- [Log chat history](chat-bots.md#chat-log)
|
||||
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
|
||||
- [Anti AFK](chat-bots.md#anti-afk)
|
||||
- [Auto Relog](chat-bots.md#auto-relog)
|
||||
- [Script Scheduler](chat-bots.md#script-scheduler)
|
||||
- [Remote Control](chat-bots.md#remote-control)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
- [Auto Attack](chat-bots.md#auto-attack)
|
||||
- [Auto Fishing](chat-bots.md#auto-fishing)
|
||||
- [Auto Eat](chat-bots.md#auto-eat)
|
||||
- [Auto Craft](chat-bots.md#auto-craft)
|
||||
- [Mailer Bot](chat-bots.md#mailer)
|
||||
- [Auto Drop](chat-bots.md#auto-drop)
|
||||
- [Replay Mod](chat-bots.md#replay-mod)
|
||||
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
||||
- [Docker Support](installation.md#using-docker)
|
||||
- [Inventory Handling](usage.md#inventory)
|
||||
- [Terrain Traversing](usage.md#move)
|
||||
- Entity Handling
|
||||
|
||||
_NOTE: Some of mentioned features are disabled by default and you will have to turn them on in the configuration file and some may require additional configuration on your part for your specific usage._
|
||||
|
||||
## Why Minecraft Console Client?
|
||||
|
||||
- Easy to use
|
||||
- Helpful community
|
||||
- Open-Source
|
||||
- Fast performance
|
||||
- Cross-Platform
|
||||
- Docker Support
|
||||
- 10 years of continuous development
|
||||
- Active contributors
|
||||
- Widely used
|
||||
|
||||
## Quick Intro
|
||||
|
||||
Don't have time to read through the documentation, we got you, our community has made some simple introduction videos about the **Minecraft Console Client**.
|
||||
|
||||
### The list of the tutorials:
|
||||
|
||||
Installation:
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
Using Commands, Scripts and other features:
|
||||
|
||||
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
||||
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
||||
|
||||
## Getting Help
|
||||
|
||||
MCC has a community that is willing to help, we have a Discussions section in out Git Hub repository.
|
||||
|
||||
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) to access it.
|
||||
|
||||
### Before getting help
|
||||
|
||||
- **Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!**
|
||||
- **Please be kind and patient, respect others as they're the ones using their time to help you**
|
||||
|
||||
## Bugs, Ideas, Feature Requests
|
||||
|
||||
Bug reporting, idea submitting or feature requesting are done in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [Github repository]([here](https://github.com/MCCTeam/Minecraft-Console-Client)).
|
||||
|
||||
Navigate to the Issues section, search for a bug, idea or a feature using the search option here in the documentation and in the `Issues` section on Git Hub before making your own.
|
||||
|
||||
If you haven't found anything similar, go ahead and click on the `New issue` button, then choose what you want to do.
|
||||
|
||||
If you're reporting a bug, please be descriptive as much as possible, try to explain how to re-create the bug, attack screenshots and logs, make sure that you have [`debugmessages`](configuration.me#debugmessages) set to `true` before sending a bug report or taking a screenshot.
|
||||
|
||||
### Before submitting
|
||||
|
||||
- **Please use the search option here or in the `Issues` section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!**
|
||||
- **Please be kind, patient and respect others. Thank you!**
|
||||
|
||||
## Notes on some features
|
||||
|
||||
### Inventory, Terrain and Entity Handling
|
||||
|
||||
Inventory handling is currently not supported in versions: `1.4.6 - 1.9`
|
||||
|
||||
Terrain handling is currently not supported in versions: `1.4.6 - 1.6`
|
||||
|
||||
Entity handling is currently not supported in versions: `1.4.6 - 1.9` (but `1.8` and `1.9` are being worked on, almost at the working state, only `EntityMetadata` packet remains to be fixed)
|
||||
|
||||
There features might not always be implemented in the latest version of the game, since they're often subjected to major changes by Mojang, and we need some time to figure out what has changed and to implement the required changes.
|
||||
|
||||
If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.
|
||||
|
||||
## Credits
|
||||
|
||||
_Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
||||
|
||||
Many features would not have been possible without the help of our talented community:
|
||||
|
||||
**Maintainers**
|
||||
|
||||
ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte
|
||||
|
||||
**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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
||||
|
||||
**Bug Hunters**
|
||||
|
||||
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, 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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
||||
|
||||
**Contributors**
|
||||
|
||||
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
||||
|
||||
**Libraries:**
|
||||
|
||||
Minecraft Console Client also borrows code from the following libraries:
|
||||
|
||||
| Name | Purpose | Author | License |
|
||||
| ----------- | ---------------- | ---------------- | ------- |
|
||||
| Biko | Proxy handling | Benton Stark | MIT |
|
||||
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
||||
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
||||
|
||||
## Disclaimer
|
||||
|
||||
Even if everything should work, we are not responsible for 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 from the source code.
|
||||
|
||||
Also, remember that when you connect to a server with this program, you will appear where you left the last time. This means that **you can die if you log in in an unsafe place on a survival server!** Use the script scheduler bot to send a teleport command after logging in.
|
||||
|
||||
We remind you that **you may get banned** by your server for using this program. Use accordingly with server rules.
|
||||
|
||||
## License
|
||||
|
||||
Minecraft Console Client is a totally free of charge, open source project. The source code is available at [Github Repository](https://github.com/MCCTeam/Minecraft-Console-Client)
|
||||
|
||||
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html) Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|
||||
1921
docs/cs/guide/chat-bots.md
Normal file
1921
docs/cs/guide/chat-bots.md
Normal file
File diff suppressed because it is too large
Load diff
1185
docs/cs/guide/configuration.md
Normal file
1185
docs/cs/guide/configuration.md
Normal file
File diff suppressed because it is too large
Load diff
76
docs/cs/guide/contibuting.md
Normal file
76
docs/cs/guide/contibuting.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# Contributing
|
||||
|
||||
At this moment this page needs to be created.
|
||||
|
||||
For now you can use our article from the [Git Hub repository Wiki](https://github.com/MCCTeam/Minecraft-Console-Client/wiki/Update-console-client-to-new-version) written by [ReinforceZwei](https://github.com/ReinforceZwei).
|
||||
|
||||
## Translations
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* **`en.ini` : English - English**
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
### Add new translation
|
||||
|
||||
1. First you need to get the name of the translated file.
|
||||
* Visit [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) and find the first occurrence of the language you need to translate in the table below.
|
||||
* Use the language code of the row in the table as the name of the translation file.
|
||||
* For example:
|
||||
* `English` -> row `English 0x0009` -> `en` -> `en.ini`
|
||||
* `Chinese (Traditional)` -> row `Chinese (Traditional) 0x7C04` -> `zh-Hant` -> `zh-Hant.ini`
|
||||
|
||||
2. Which system languages are recommended to use this translation?
|
||||
* Still check the table in [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c), one language may have multiple rows.
|
||||
* You will need to indicate which language codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `de.ini` applies to `de`, `de-AT`, `de-BE`, `de-DE`, ...
|
||||
* Translation `zh-Hans.ini` applies to `zh-Hans`, `zh`, `zh-CN`, `zh-SG`.
|
||||
|
||||
3. Which game languages are recommended to use this translation?
|
||||
* Check out the table in [this link](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239), where the `Locale Code` column indicates the language code in minecraft.
|
||||
* You will need to indicate which locale codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `fr.ini` applies to `fr_ca`, `fr_fr`.
|
||||
* Translation `zh-Hans.ini` applies to `zh_cn`.
|
||||
|
||||
4. Add the new translation to the code. (Optional)
|
||||
* **If you are not familiar with programming, you can skip this step and just write the above information in your PR or issue.**
|
||||
* Add the newly created translation file `xx.ini` to the project `/Resources/lang/xx.ini`.
|
||||
* Open `/DefaultConfigResource.resx`.
|
||||
* Click `Add Resources`.
|
||||
* Choose `/Resources/lang/xx.ini`.
|
||||
* Rename the added resource file in `/DefaultConfigResource.resx` to `Translation_xx`.
|
||||
* Open `/Translations.cs`.
|
||||
* Find `public static Tuple<string, string[]> GetTranslationPriority();`
|
||||
* Update the mapping of system language codes to translation files.
|
||||
* Find `public static string[] GetTranslationPriority(string gameLanguage);`
|
||||
* Update the mapping of game locale code to translation files.
|
||||
|
||||
5. Follow the section "Update existing translation".
|
||||
|
||||
### Update existing translation
|
||||
|
||||
1. Visit [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang), download `en.ini` and the language you want to translate(`xx.ini`).
|
||||
|
||||
2. Compare `en.ini` and `xx.ini` and update outdated or non-existent entries in `xx.ini`.
|
||||
|
||||
3. 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.
|
||||
|
||||
### Translate README.md
|
||||
|
||||
1. Get the English version of the README.md from [here](https://raw.githubusercontent.com/MCCTeam/Minecraft-Console-Client/master/README.md).
|
||||
|
||||
2. See `Add new translation -> 1.` for the target language code. Assume it is `xx`.
|
||||
|
||||
3. Complete the translation according to the English README.md and name the translated version as `README-xx.md`.
|
||||
|
||||
4. In the English README, above the "About" section, add the name of the language and a hyperlink to `README-xx.md`.
|
||||
|
||||
## Contributors
|
||||
|
||||
[Check out our contributors on Github](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors).
|
||||
170
docs/cs/guide/creating-bots.md
Normal file
170
docs/cs/guide/creating-bots.md
Normal file
|
|
@ -0,0 +1,170 @@
|
|||
# Creating Chat Bots
|
||||
|
||||
- [Notes](#notes)
|
||||
- [Requirements](#requirements)
|
||||
- [Quick Introduction](#quick-introduction)
|
||||
- [Examples](#examples)
|
||||
- [C# API](#c#-api)
|
||||
|
||||
## Notes
|
||||
|
||||
> **ℹ️ NOTE: For now this page contains only the bare basics of the Chat Bot API, enough of details to teach you how to make basic Chat Bots. For more details you need to take a look at the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) and [Examples](#examples). This page will be improved in the future.**
|
||||
|
||||
**Minecraft Console Client** has a rich C# API which allows you to create Chat Bots (effectively plugins) which can help you create complex automations which normal scripts may not be able to do.
|
||||
|
||||
## Requirements
|
||||
|
||||
- A basic knowledge of C# programming language
|
||||
- A text editor
|
||||
|
||||
If you're not familiar with the C# programming language, we suggest taking a look at the following resources:
|
||||
|
||||
Crash courses:
|
||||
|
||||
- [C# Crash Course playlist by Teddy Smit](https://www.youtube.com/watch?v=67oWw9TanOk&list=PL82C6-O4XrHfoN_Y4MwGvJz5BntiL0z0D)
|
||||
|
||||
More in-depth:
|
||||
|
||||
- [Learn C# Youtube Playlist by Microsoft](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oVxKLQCHpiUWun7vlJJvUiN)
|
||||
- [Getting started with C# (An index of tutorials and the documentation) by Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/)
|
||||
|
||||
## Quick Introduction
|
||||
|
||||
This introduction assumes that you have the basic knowledge of C#.
|
||||
|
||||
> **ℹ️ NOTE: Here we will use terms Chat Bot and Script interchangeably**
|
||||
|
||||
Create a new empty file and name it `ExampleChatBot.cs` in the same folder where you have your MCC installed.
|
||||
|
||||
Paste the following example code:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
|
||||
// The code and comments above are defining a "Script Metadata" section
|
||||
|
||||
// Every single chat bot (script) must be a class which extends the ChatBot class.
|
||||
// Your class must be instantiates in the "Script Metadata" section and passed to MCC.LoadBot function.
|
||||
class ExampleChatBot : ChatBot
|
||||
{
|
||||
// This method will be called when the script has been initialized for the first time, it's called only once
|
||||
// Here you can initialize variables, eg. Dictionaries. etc...
|
||||
public override void Initialize()
|
||||
{
|
||||
LogToConsole("An example Chat Bot has been initialized!");
|
||||
}
|
||||
|
||||
// This is a function that will be run when we get a chat message from a server
|
||||
// In this example it just detects the type of the message and prints it out
|
||||
public override void GetText(string text)
|
||||
{
|
||||
string message = "";
|
||||
string username = "";
|
||||
text = GetVerbatim(text);
|
||||
|
||||
if (IsPrivateMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has sent you a private message: " + message);
|
||||
}
|
||||
else if (IsChatMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has said: " + message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Start MCC, connect to a server and run the following internal command: `/script ExampleChatBot.cs`.
|
||||
|
||||
If you did everything right you should see: `[Example Chat Bot] An example Chat Bot has been initialised!` message appear in your console log.
|
||||
|
||||
### Structure of Chat Bots
|
||||
|
||||
Chat Bot (Script) structure is the following:
|
||||
|
||||
```
|
||||
<script metadata>
|
||||
<chat bot class>
|
||||
```
|
||||
|
||||
**Script Metadata** is a section with a custom format that mixes in C# with our format using comments. Every single Chat Bot (Script) must have this section at the beginning in order to work.
|
||||
|
||||
### Script Metadata Format
|
||||
|
||||
`//MCCScript 1.0` marks the beginning of the **Script Metadata** section, this must always be on the first line or the Chat Bot (Script) will not load and will throw an error.
|
||||
|
||||
`//MCCScript Extensions` marks the end of the **Script Metadata** section, this must be defined before a Chat Bot (Script) class.
|
||||
|
||||
In order for your Chat Bot (Script) to properly load in-between the `//MCCScript 1.0` and the `//MCCScript Extensions` lines you must instantiate your Chat Bot (Script) class and pass it to the `MCC.LoadBot` function.
|
||||
|
||||
Example code:
|
||||
|
||||
```
|
||||
MCC.LoadBot(new YourChatBotClassNameHere());
|
||||
```
|
||||
|
||||
**Script Metadata** section allows for including C# packages and libraries with: `//using <namespace>` and `/dll <dll name>`.
|
||||
|
||||
> **ℹ️ NOTE: Avoid adding whitespace between `//` and keywords**
|
||||
|
||||
By the default the following packages are loaded:
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Text.RegularExpressions;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.IO;
|
||||
using System.Net;
|
||||
using System.Threading;
|
||||
using MinecraftClient;
|
||||
using MinecraftClient.Mapping;
|
||||
using MinecraftClient.Inventory;
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```csharp
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
```
|
||||
|
||||
Full Example:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
```
|
||||
|
||||
### Chat Bot Class
|
||||
|
||||
After the end of the **Script Metadata** section, you basically can define any number of classes you like, the only limitation is that the main class of your Chat Bot (Script) must extend `ChatBot` class.
|
||||
|
||||
There are no required methods, everything is optional.
|
||||
|
||||
When the Chat Bot (Script) has been initialized for the first time the `Initialize` method will be called. In it you can initialize variables, eg. Dictionaries, etc..
|
||||
|
||||
> **ℹ️ NOTE: For allocating resources like a database connection, we recommend allocating them in `AfterGameJoined` and freeing them in `OnDisconnect`**.
|
||||
|
||||
## Examples
|
||||
|
||||
You can find a lot of examples in our Git Hub Repository at [ChatBots](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/ChatBots) and [config](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config).
|
||||
|
||||
## C# API
|
||||
|
||||
As of the time of writing, the C# API has been changed in forks that are yet to be merged, so for now you can use the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) for reference.
|
||||
|
||||
Each method is well documented with standard C# documentation comments.
|
||||
|
||||
In the future we will make a script to auto-generate this section based on the documentation in the code.
|
||||
931
docs/cs/guide/installation.md
Normal file
931
docs/cs/guide/installation.md
Normal file
|
|
@ -0,0 +1,931 @@
|
|||
# Installation
|
||||
|
||||
- [YouTube Tutorials](#youtube-tutorials)
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker)
|
||||
- [Run on Android](#run-on-android)
|
||||
- [Run MCC 24/7 on a VPS](#run-on-a-vps)
|
||||
|
||||
## YouTube Tutorials
|
||||
|
||||
If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
## Download a compiled binary
|
||||
|
||||
In order to run **Minecraft Console Client** you need [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download)
|
||||
|
||||
> **⚠️ IMPORTANT: If you already have .NET, but an older version than `6.0`, please update to `6.0` since MCC might not work as expected or at all.**
|
||||
|
||||
#### How to install .NET on your platform
|
||||
|
||||
- [Install .NET on Windows](https://docs.microsoft.com/en-us/dotnet/core/install/windows)
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Download
|
||||
|
||||
You can download a compiled binary file of the latest build from our Releases section on Git Hub: [Download](https://github.com/MCCTeam/Minecraft-Console-Client/releases)
|
||||
|
||||
## Building from the source code
|
||||
|
||||
### Windows
|
||||
|
||||
Requirements:
|
||||
|
||||
- [Git](https://www.git-scm.com/)
|
||||
- [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
Install [Git](https://www.git-scm.com/)
|
||||
|
||||
1. Make a new folder where you want to keep the source code
|
||||
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
|
||||
3. Click on `Git Bash Here` in the context menu
|
||||
4. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
|
||||
6. Open up the new cloned folder
|
||||
|
||||
#### Building using the Visual Studio
|
||||
|
||||
1. Open up the `MinecraftClient.sln` via Visual Studio
|
||||
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
3. Click on `Properties`
|
||||
4. Open up the `Build` tab and select configuration `Release`
|
||||
5. Press `CTRL + S` and close the file
|
||||
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
7. Click `Build`
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
#### Building using .NET manually without Visual Studio
|
||||
|
||||
1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
|
||||
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
|
||||
3. Run the following command to build the project:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r win-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
### Linux, macOS
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
|
||||
- Linux:
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**
|
||||
|
||||
- [Install Git on macOS](https://git-scm.com/download/mac)
|
||||
|
||||
- .NET SDK 6.0 or new-er
|
||||
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
1. Open up a terminal emulator and navigate to the folder where you will store the MCC
|
||||
2. Recursively clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)
|
||||
4. Run the following command to build the project:
|
||||
|
||||
- On Linux:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r linux-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux that is either ARM, 32-bit, Rhel based, Using Musl, or Tirzen, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace the `'-r linux-64` with an appropriate `-r <your RID>` (Example for arm: `-r linux-arm64`)**
|
||||
|
||||
- On macOS:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r osx-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're not using MAC with Intel, find an appropriate RID for your ARM processor, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) and replace the `'-r osx-64` with an appropriate `-r <your RID>` (Example for arm: `-r osx.12-arm64`)**
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient` will be in:
|
||||
|
||||
- Linux: `MinecraftClient/bin/Release/net6.0/linux-x64/publish/`
|
||||
- macOS: `MinecraftClient/bin/Release/net6.0/osx-x64/publish/`
|
||||
|
||||
## Using Docker
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
- Docker
|
||||
|
||||
> **ℹ️ NOTE: This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**
|
||||
|
||||
> **⚠️ WARNING: Pay attention at warnings, Docker currently works, but you must start the containers in the interactive mode or MCC will crash, we're working on solving this.**
|
||||
|
||||
1. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
2. Navigate to `Minecraft-Console-Client/Docker`
|
||||
3. Build the image using the following command
|
||||
|
||||
```bash
|
||||
docker build -t minecraft-console-client:latest .
|
||||
```
|
||||
|
||||
**Start the container using Docker:**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: There is a bug with the ConsoleInteractive which causes a crash when a container is started in a headless mode, so you need to use the interactive mode. Do not restart containers in a classic way, stop then and start them with interactive mode (this command), after that simply detach with `CTRL + P` and then `CTRL + Q`.**
|
||||
|
||||
```bash
|
||||
# You could also ignore the -v parameter if you dont want to mount the volume that is up to you. If you don't it's harder to edit the .ini file if thats something you want to do
|
||||
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
|
||||
```
|
||||
|
||||
Now you could login and the Client is running. To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`. To reattach use the `docker attach` command.
|
||||
|
||||
**Start the container using docker-compose:**
|
||||
|
||||
By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.
|
||||
|
||||
If you don't want to map a volume, you have to comment out or delete the entire volumes section:
|
||||
|
||||
```yml
|
||||
#volumes:
|
||||
#- './data:/opt/data'
|
||||
```
|
||||
|
||||
Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:
|
||||
|
||||
```bash
|
||||
docker-compose run MCC
|
||||
```
|
||||
|
||||
Remember to remove the container after usage:
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
If you use the INI file and entered your data (username, password, server) there, you can start your container using
|
||||
|
||||
```bash
|
||||
docker-compose up
|
||||
docker-compose up -d #for deamonized running in the background
|
||||
```
|
||||
|
||||
Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`. As above, you can stop and remove the container using
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Run on Android
|
||||
|
||||
It is possible to run the Minecraft Console Client on Android through Termux and Ubuntu 22.04 in it, however it requires a manual setup with a lot of commands, be careful no to skip any steps. Note that this might take anywhere from 10 to 20 minutes or more to do depending on your technical knowledge level, Internet speed and CPU speed.
|
||||
|
||||
> **ℹ️ NOTE: This section is going to get a bit technical, I'll try my best to make everything as simple as possible. If you are having trouble following along or if you encounter any issues, feel free to open up a discussion on our Github repository page.**
|
||||
|
||||
> **ℹ️ NOTE: You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**
|
||||
|
||||
> **ℹ️ NOTE: Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**
|
||||
|
||||
### Installation
|
||||
|
||||
#### Termux
|
||||
|
||||
> **⚠️ IMPORTANT: The Play Store version of Termux is outdated and not supported, do not use it, use the the [Github one](https://github.com/termux/termux-app/releases/latest/).**
|
||||
|
||||
Go to [the Termux Github latest release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it and run it.
|
||||
|
||||
> **ℹ️ NOTE: If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!**
|
||||
|
||||
#### Installing Ubuntu 22.04
|
||||
|
||||
At this stage, you have 2 options:
|
||||
|
||||
1. Following this textual tutorial
|
||||
2. Watching a [Youtube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM)
|
||||
|
||||
> **ℹ️ NOTE: If you decide to watch the Youtube tutorial, watch only up to `1:58`, the steps after are not needed and might just confuse you.**
|
||||
|
||||
In order to install Ubuntu 22.04 in Termux you require `wget` and `proot`, we're going to install them in the next step.
|
||||
|
||||
Once you have Termux installed open it up and run the following command one after other (in order):
|
||||
|
||||
1. `pkg update`
|
||||
2. `pkg upgrade`
|
||||
3. `pkg install proot wget`
|
||||
|
||||
> **ℹ️ NOTE: If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter**
|
||||
|
||||
Then you need to download an installation script using the following command:
|
||||
|
||||
```bash
|
||||
wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh
|
||||
```
|
||||
|
||||
Once the script has downloaded, run it with:
|
||||
|
||||
```bash
|
||||
bash ubuntu.sh
|
||||
```
|
||||
|
||||
Then you will be asked a question, enter `Y` and press `Enter`. Once the installation is complete, you can start Ubuntu with:
|
||||
|
||||
```bash
|
||||
./startubuntu.sh
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command**
|
||||
|
||||
#### Installing .NET on ARM
|
||||
|
||||
Since there are issues installing .NET 6.0 via the APT package manager at the time of writing, we will have to install it manually.
|
||||
|
||||
First we need to update the APT package manager repositories and install dependencies.
|
||||
|
||||
To update the APT repositories, run the following command:
|
||||
|
||||
```bash
|
||||
apt update -y && apt upgrade -y
|
||||
```
|
||||
|
||||
After you did it, we need to install dependencies for .NET, with the following command:
|
||||
|
||||
```bash
|
||||
apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y
|
||||
```
|
||||
|
||||
After you have installed dependencies, it's time to install .NET, you either can follow this tutorial or the [Microsoft one](https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install).
|
||||
|
||||
Navigate to your `/root` home directory with the following command:
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
```
|
||||
|
||||
First you need to download .NET 6.0, you can do it with the following command:
|
||||
|
||||
```bash
|
||||
wget https://download.visualstudio.microsoft.com/download/pr/901f7928-5479-4d32-a9e5-ba66162ca0e4/d00b935ec4dc79a27f5bde00712ed3d7/dotnet-sdk-6.0.400-linux-arm64.tar.gz
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you have 64 bit version of ARM processor, if you happen to have a 32-bit version replace the link in the command above with [this one](https://download.visualstudio.microsoft.com/download/pr/cf567026-a29a-41aa-bc3a-e4e1ad0df480/0925d411e8e09e31ba7a39a3eb0e29af/aspnetcore-runtime-6.0.8-linux-arm.tar.gz)**.
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you're following along and using Ubuntu 22.04, if you're using a different distro, like Alpine, go to [here](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) and copy an appropriate link for your distro.**
|
||||
|
||||
Once the file has been downloaded, you need to run the following commands in order:
|
||||
|
||||
1. `DOTNET_FILE=dotnet-sdk-6.0.400-linux-arm64.tar.gz`
|
||||
|
||||
> **⚠️ IMPORTANT: If you're using a different download link, update the file name in this command to match your version.**
|
||||
|
||||
2. `export DOTNET_ROOT=/root/.dotnet`
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"`
|
||||
4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools`
|
||||
|
||||
Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located.
|
||||
|
||||
> **⚠️ IMPORTANT: You will need a basic knowledge of Nano text editor, if you do not know how to use it, watch this [Youtube video tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A)**
|
||||
|
||||
To enable this, we need to edit our `/root/.bashrc` file with the following command:
|
||||
|
||||
```bash
|
||||
nano /root/.bashrc
|
||||
```
|
||||
|
||||
Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text:
|
||||
|
||||
```bash
|
||||
export DOTNET_ROOT=/root/.dotnet/
|
||||
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
|
||||
```
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter.
|
||||
|
||||
Veryfy that .NET was installed correctly by running:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get a help page:
|
||||
|
||||
```bash
|
||||
root@localhost:~# dotnet
|
||||
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
#### Installing MCC
|
||||
|
||||
Finally, we can install MCC.
|
||||
|
||||
> **⚠️ IMPORTANT: If you have a 32 ARM processor, you need to build the MCC yourself, take a look at the [Building From Source](#building-from-the-source-code) section. Also make sure to be using the appropriate `-r` parameter value for your architecture.**
|
||||
|
||||
Let's make a folder where the MCC will be stored with the following command:
|
||||
|
||||
```bash
|
||||
mkdir MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Then enter it the newly created folder:
|
||||
|
||||
```bash
|
||||
cd MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Download the MCC with the following command:
|
||||
|
||||
```bash
|
||||
wget https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest/download/MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
Unzip it with the following command:
|
||||
|
||||
```bash
|
||||
unzip MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
You can remove the zip archive now, we do not need it anymore, with:
|
||||
|
||||
```bash
|
||||
rm MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
And finally run it with:
|
||||
|
||||
```
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
#### After installation
|
||||
|
||||
When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh`
|
||||
|
||||
Then you can start the MCC again with `./MinecraftClient`
|
||||
|
||||
To stop MCC from running you can press `CTRL + C`
|
||||
|
||||
To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use, if you have followed the installation steps above, you should be familiar with it, if not, check out [this tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).
|
||||
|
||||
For downloading files, you can use the `wget` file we have installed, simply run: `wget your_link_here` (you have examples above, and a video tutorial down bellow).
|
||||
|
||||
Also, here are some linux tutorials for people who are new to it:
|
||||
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
## Run on a VPS
|
||||
|
||||
> **ℹ️ NOTE: This is a new section, if you find a mistake, please report it by opening an Issue in our [Github repository](https://github.com/MCCTeam/Minecraft-Console-Client). Thank you!**
|
||||
|
||||
The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.
|
||||
|
||||
- [What is a VPS?](#what-is-a-vps)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Where to get a VPS](#where-to-get-a-vps)
|
||||
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
|
||||
- [Initial VPS setup](#initial-vps-setup)
|
||||
- [Creating a new user account](#creating-a-new-user)
|
||||
- [Installing .NET Core 6](#installing-net-core-6)
|
||||
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)
|
||||
|
||||
### What is a VPS?
|
||||
|
||||
VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).
|
||||
|
||||
You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.
|
||||
|
||||
Here is a [Youtube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you're interested.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. Gitbash (if you're on Windows)
|
||||
|
||||
Download and install [Gitbash](https://git-scm.com/downloads).
|
||||
|
||||
> **ℹ️ NOTE: Make sure to allow the installation to add it to the context menu**
|
||||
|
||||
2. `ssh` and `ssh-keygen` commands (On Windows they're available with Gitbash, on macOs and Linux they should be available by default, it not, search on how to install them)
|
||||
|
||||
3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.
|
||||
|
||||
If you already know this, feel free to skip.
|
||||
|
||||
if you get stuck, watch those tutorials.
|
||||
|
||||
If you're new to this, you can learn about it here:
|
||||
|
||||
- [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
### Where to get a VPS
|
||||
|
||||
You have 2 options:
|
||||
|
||||
- [Buying a VPS](#buying-a-vps)
|
||||
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)
|
||||
|
||||
#### Buying a VPS
|
||||
|
||||
If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.
|
||||
|
||||
**What hardware requirements I need for running the MCC?**
|
||||
|
||||
The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.
|
||||
|
||||
**Where to buy a VPS?**
|
||||
|
||||
> **⚠️ VERY IMPORTANT: In this tutorial we will be using `Ubuntu 22.04`, make sure to select it as the OS when buying a VPS.**
|
||||
|
||||
Some of the reliable and cheap hosting providers (sorted for price/performance):
|
||||
|
||||
- [E-Trail](https://e-trail.net/vps)
|
||||
|
||||
**Minimum price**: `2.50 EUR / month`
|
||||
|
||||
> **ℹ️ NOTE: Does not have Ubuntu 22.04 in the dropdown menu when ordering, you will have to re-install later or ask support to do it.**
|
||||
|
||||
- [OVH Cloud](https://www.ovhcloud.com/de/vps/)
|
||||
|
||||
**Minimum price**: `3.57 EUR / month`
|
||||
|
||||
- [Hetzner Cloud](https://www.hetzner.com/cloud)
|
||||
|
||||
**Minimum price**: `4.51 EUR / month`
|
||||
|
||||
- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)
|
||||
|
||||
**Minimum price**: `4 EUR / month`
|
||||
|
||||
- [Contabo](https://contabo.com/en/vps/)
|
||||
|
||||
**Minimum price**: `7 EUR / month`
|
||||
|
||||
**More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**
|
||||
|
||||
You also may want to search for better deals.
|
||||
|
||||
#### AWS EC2 VPS
|
||||
|
||||
> **⚠️ VERY IMPORTANT: This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**
|
||||
|
||||
> **⚠️ WARNING: Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**
|
||||
|
||||
> **⚠️ WARNING: Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**
|
||||
|
||||
> **ℹ️ NOTE: If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**
|
||||
|
||||
Register on AWS and enter all of your billing info and a phone number. Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).
|
||||
|
||||
### Initial Amazon VPS setup
|
||||
|
||||
> **ℹ️ NOTE: Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**
|
||||
|
||||
When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`
|
||||
|
||||
> **ℹ️ NOTE: Make sure to select the region closest to you for the minimal latency**
|
||||
|
||||
Click on the **Launch instance** button.
|
||||
|
||||
Fill out the `Name` field with a name of your preference.
|
||||
|
||||
|
||||
|
||||
For the **Application and OS images** select `Ubuntu Server 22.04 LTS (HVM), SSD Volume Type`.
|
||||
|
||||
> **⚠️ VERY IMPORTANT: Make sure that it has `Free tier eligible` next to it.**
|
||||
|
||||
|
||||
|
||||
For the **Instance type** select `t2.micro`.
|
||||
|
||||
For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.
|
||||
|
||||
> **⚠️ EXTREMELY IMPORTANT: Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**
|
||||
|
||||
|
||||
|
||||
For the **Network settings** check the following checkboxes on:
|
||||
|
||||
- `Allow SSH traffic from` (Anywhere)
|
||||
- `Allow HTTPs traffic from the internet`
|
||||
- `Allow HTTP traffic from the internet`
|
||||
|
||||
> **ℹ️ NOTE: The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**
|
||||
|
||||
|
||||
|
||||
For the **Storage** enter `30`.
|
||||
|
||||
|
||||
|
||||
Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.
|
||||
|
||||
Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.
|
||||
|
||||
You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
In order to login with SSH, you are going to use the following command:
|
||||
|
||||
```bash
|
||||
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<` and `>` are not typed, that is just a notation for a placeholder!**
|
||||
|
||||
> **ℹ️ NOTE: `ubuntu` is a default root account username for Ubuntu on AWS!**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
|
||||
```
|
||||
|
||||
If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.
|
||||
|
||||
Now you can continue to [Creating a new user](#creating-a-new-user)
|
||||
|
||||
### Initial VPS setup
|
||||
|
||||
> **ℹ️ NOTE: This section if for those who do not use AWS, if you use AWS skip it**
|
||||
|
||||
When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.
|
||||
|
||||
Other option is that you will get your login info in the email once the setup is done.
|
||||
|
||||
Once you have the root login account info, you need [Gitbash](https://git-scm.com/downloads) on Windows and `ssh` if you're on macOS or Linux (if you do not have it by some chance, search on how to install it, it is simple).
|
||||
|
||||
If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:
|
||||
|
||||
```bash
|
||||
ssh <username>@<ip>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh root@142.26.73.14
|
||||
```
|
||||
|
||||
Example with port:
|
||||
|
||||
```bash
|
||||
ssh -p 2233 root@142.26.73.14
|
||||
```
|
||||
|
||||
Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.
|
||||
|
||||
### Creating a new user
|
||||
|
||||
Once you've logged in to your VPS you need to create a new user and give it SSH access.
|
||||
|
||||
In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.
|
||||
|
||||
> **ℹ️ NOTE: You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**
|
||||
|
||||
To create a new user named `mcc` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo useradd mcc -m
|
||||
```
|
||||
|
||||
Now we need to give it a password, execute the following command, type the password and confirm it:
|
||||
|
||||
```bash
|
||||
sudo passwd mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: When you're typing a password it will not be displayed on the screen, but you're typing it for real.**
|
||||
|
||||
> **ℹ️ NOTE: Make sure you have a strong password!**
|
||||
|
||||
Now we need to give our user account the admin permissions:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG sudo mcc
|
||||
```
|
||||
|
||||
Now we are going to set it's shell to bash:
|
||||
|
||||
```bash
|
||||
sudo chsh mcc -s /bin/bash
|
||||
```
|
||||
|
||||
Now we need to log in as the `mcc` user:
|
||||
|
||||
```bash
|
||||
su mcc
|
||||
```
|
||||
|
||||
Fill in your password when asked.
|
||||
|
||||
Navigate to the `mcc` user home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Make a new `.ssh` directory:
|
||||
|
||||
```bash
|
||||
mkdir .ssh
|
||||
```
|
||||
|
||||
Enter it with:
|
||||
|
||||
```bash
|
||||
cd .ssh
|
||||
```
|
||||
|
||||
Make a new empty file named `authorized_keys`:
|
||||
|
||||
```bash
|
||||
touch authorized_keys
|
||||
```
|
||||
|
||||
Do no close the Git bash/Terminal emulator. On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account. Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
Type the following command:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t RSA -b 4096
|
||||
```
|
||||
|
||||
Enter the name of the key file to be: `MCC_Key`, press Enter.
|
||||
|
||||
When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.
|
||||
|
||||
This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.
|
||||
|
||||
Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.
|
||||
|
||||
Return to the Git Bash/Terminal emulator and execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install nano -y
|
||||
```
|
||||
|
||||
This will install the Nano editor on your VPS.
|
||||
|
||||
Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.
|
||||
|
||||
Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:
|
||||
|
||||
```bash
|
||||
pwd
|
||||
```
|
||||
|
||||
If it does not print `/home/mcc/.ssh`, navigate to it with:
|
||||
|
||||
```bash
|
||||
cd /home/mcc/.ssh
|
||||
```
|
||||
|
||||
Now you need to open the `authorized_keys` file with the nano editor:
|
||||
|
||||
```bash
|
||||
nano authorized_keys
|
||||
```
|
||||
|
||||
Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.
|
||||
|
||||
Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.
|
||||
|
||||
Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:
|
||||
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
```
|
||||
|
||||
Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.
|
||||
|
||||
Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.
|
||||
|
||||
Additionally for better security you can do the following:
|
||||
|
||||
- Set `PermitRootLogin` to `yes`
|
||||
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
|
||||
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)
|
||||
|
||||
Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.
|
||||
|
||||
Now we need to restart the SSHD service with:
|
||||
|
||||
```bash
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
Let's check if everything is working correctly:
|
||||
|
||||
```bash
|
||||
sudo systemctl status sshd
|
||||
```
|
||||
|
||||
If everything has been configured as it should be you should see `active (running)` as a status of the service. If not, open the config file again and check for mistakes.
|
||||
|
||||
Press `q` to exit the log mode.
|
||||
|
||||
Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.
|
||||
|
||||
Now we can login to the user with our private `MCC_Key` file.
|
||||
|
||||
Command:
|
||||
|
||||
```bash
|
||||
ssh -i <path to the MCC_Key private key> mcc@<ip here>
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i MCC_Key mcc@3.71.108.69
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**
|
||||
|
||||
If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.
|
||||
|
||||
You can do `whoami` to see your username.
|
||||
|
||||
Now you can install .NET Core 6 and MCC.
|
||||
|
||||
### Installing .NET Core 6
|
||||
|
||||
> **ℹ️ NOTE: If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**
|
||||
|
||||
> **⚠️ WARNING: With newer versions of .NET Core 6 on Ubuntu 22.04 you might get the following error: `A fatal error occurred, the folder [/usr/share/dotnet/host/fxr] does not contain any version-numbered child folders`, if you get it, use [this solution](https://github.com/dotnet/sdk/issues/27082#issuecomment-1211143446)**
|
||||
|
||||
Log in as the user you've created.
|
||||
|
||||
Update the system packages and package manager repositories:
|
||||
|
||||
```bash
|
||||
sudo apt update -y && sudo apt upgrade -y
|
||||
```
|
||||
|
||||
Install `wget`:
|
||||
|
||||
```bash
|
||||
sudo apt install wget -y
|
||||
```
|
||||
|
||||
Go to your home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Download the Microsoft repository file:
|
||||
|
||||
```bash
|
||||
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Add Microsoft repositories to the package manager:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Remove the file, we do not need it anymore:
|
||||
|
||||
```bash
|
||||
rm packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Finally, install .NET Core 6:
|
||||
|
||||
```bash
|
||||
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-6.0
|
||||
```
|
||||
|
||||
Run the following command to check if everything was installed correctly:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get:
|
||||
|
||||
```
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
If you do not get this output and the installation was not successful, [try other methods](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu#2204).
|
||||
|
||||
If it was successful, you can now install the MCC.
|
||||
|
||||
### Installing MCC on a VPS
|
||||
|
||||
Now that you have .NET Core 6.0 and a user account, you should install the `screen` utility, you will need this in order to keep the MCC running once you close down the SSH session (if you do not have it, the MCC will just stop working once you disconnect). You can look at the `screen` like a window, except it's in a terminal, it lets you have multiple "windows" open at the same time.
|
||||
|
||||
> **ℹ️ NOTE: There is also a Docker method, if you're using Docker, you do not need the `screen` program.**
|
||||
|
||||
You also can learn about the screen command from [this Youtube tutorial](https://youtu.be/_ZJiEX4rmN4).
|
||||
|
||||
To install the `screen` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install screen -y
|
||||
```
|
||||
|
||||
Now you can install the MCC:
|
||||
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)
|
||||
|
||||
How to use the `screen` command?
|
||||
|
||||
> **⚠️ WARNING: If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**
|
||||
|
||||
To start a screen, type:
|
||||
|
||||
```bash
|
||||
screen -S mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**
|
||||
|
||||
> **ℹ️ NOTE: You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**
|
||||
|
||||
Now you will be in the screen, now you can start the MCC and detach from the screen.
|
||||
|
||||
To detach from the screen press `CTRL + A + D`.
|
||||
|
||||
To re-attach/return to the screen, execute the following command:
|
||||
|
||||
```bash
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:
|
||||
|
||||
```bash
|
||||
screen -d mcc
|
||||
```
|
||||
|
||||
To list out screens you can use:
|
||||
|
||||
```bash
|
||||
screen -ls
|
||||
```
|
||||
|
||||
To stop the MCC, you can hit `CTRL + D` (hit it few times).
|
||||
919
docs/cs/guide/usage.md
Normal file
919
docs/cs/guide/usage.md
Normal file
|
|
@ -0,0 +1,919 @@
|
|||
# Usage
|
||||
|
||||
How to run the program:
|
||||
|
||||
- [Running on Windows](#windows)
|
||||
- [Running on Linux, macOS](#linux-macos)
|
||||
- [Running using Docker](#docker)
|
||||
|
||||
Using the command line parameters:
|
||||
|
||||
- [Examples](#quick-usage-of-mcc-with-examples)
|
||||
- [Command line parameters](#command-line-parameters)
|
||||
- [Internal commands](#internal-commands)
|
||||
|
||||
## Windows
|
||||
|
||||
Simply run `MinecraftClient.exe`
|
||||
|
||||
> **ℹ️ NOTE: On Windows it's best using [Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/install) for the best experience and looks. Some features like emojis in the [`/chunk`](#chunk) command do not work in CMD or Powershell 5**
|
||||
|
||||
## Linux, macOS
|
||||
|
||||
To run the client you need to type the following command in your terminal emulator:
|
||||
|
||||
```bash
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
If you want to keep it running in the background you can use `screen` (Linux only) Example:
|
||||
|
||||
```bash
|
||||
# Start the screen
|
||||
screen -S mcc
|
||||
|
||||
# Run it
|
||||
./MinecraftClient
|
||||
|
||||
# Detach from the screen by pressing CTRL + A + D
|
||||
|
||||
# Re-attach if you want to have accces again
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
_Learn more on how to use the screen command: [YouTube](https://www.youtube.com/watch?v=_ZJiEX4rmN4)_
|
||||
|
||||
## Docker
|
||||
|
||||
See [Run using Docker](./guide/installation.md#using-docker)
|
||||
|
||||
## Command-line usage
|
||||
|
||||
**Minecraft Console Client** has a plethora of useful command line parameters, here you can learn about them.
|
||||
|
||||
### For people not familiar with the command line
|
||||
|
||||
For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.
|
||||
|
||||
In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.
|
||||
|
||||
Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:
|
||||
|
||||
- `someparameter`
|
||||
- `-some-parameter`
|
||||
- `--some-other-parameter`
|
||||
- `--some-setting="some value"`
|
||||
- `-a=5`
|
||||
|
||||
Parameters with a single dash (`-`) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (`--`) are being used for parameters with a longer/full name.
|
||||
|
||||
When you are reading examples, you will often see something like this: `<something here>`, this means that this is a place holder and it should be changed with some value, excluding the `<` and the `>`.
|
||||
|
||||
For example `<username>` you need to change to an username of your liking, example: `notch` (`<` and `>` should not be included).
|
||||
|
||||
`[` and `]` mean that a parameter is an optional one.
|
||||
|
||||
They also can hold some values, example from the MCC:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
```
|
||||
|
||||
When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes (`"`), example: `--some-parameter="some text here with spaces in it"`
|
||||
|
||||
Here is an example for using a `--help` command line parameter for MCC that will print out a page on how to use MCC from the command line:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
```
|
||||
|
||||
### Quick usage of MCC with examples
|
||||
|
||||
> **ℹ️ NOTE: On Linux and macOS, you need to type: `./MinecraftClient` instead of `MinecraftClient.exe`**
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
MinecraftClient.exe <username> <password> <server>
|
||||
MinecraftClient.exe <username> <password> <server> "/mycommand"
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
MinecraftClient.exe --section.setting=value [--other settings]
|
||||
MinecraftClient.exe <settings-file.ini> [--other settings]
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
|
||||
MinecraftClient.exe notch password123 mc.someserver.com:25565
|
||||
|
||||
# Overriding a setting from MinecraftClient.ini using a command line parameter
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
|
||||
# Providing a custom settings ini file and overriding a language to Chinese
|
||||
MinecraftClient.exe CustomSettingsFile.ini --language=zh
|
||||
```
|
||||
|
||||
### Rules of using the command line parameters
|
||||
|
||||
You can mix and match arguments by following theses rules:
|
||||
|
||||
- First positional argument may be either the login or a settings file
|
||||
- Other positional arguments are read in order: login, password, server, command
|
||||
- Arguments starting with `--` can be in any order and position
|
||||
|
||||
Examples and further explanations:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server>
|
||||
```
|
||||
|
||||
- This will automatically connect you to the chosen server.
|
||||
- You may omit password and/or server to specify e.g. only the login
|
||||
- To specify a server but ask password interactively, use `""` as password.
|
||||
- To specify offline mode with no password, use `-` as password.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server> "/mycommand"
|
||||
```
|
||||
|
||||
- This will automatically send `/mycommand` to the server and close.
|
||||
- To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini>
|
||||
```
|
||||
|
||||
- This will load the specified configuration file
|
||||
- If the file contains login / password / server ip, it will automatically connect.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
```
|
||||
|
||||
- Specify settings on the command-line, see possible value in the configuration file
|
||||
- Use `--section.setting=value` for settings outside the `[Main]` section
|
||||
- Example: `--antiafk.enabled=true` for enabling the `AntiAFK` bot
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]
|
||||
```
|
||||
|
||||
- Load the specified configuration file and override some settings from the file
|
||||
|
||||
## Internal Commands
|
||||
|
||||
These commands can be performed from the chat prompt, scripts or remote control.
|
||||
|
||||
From chat prompt, commands must by default be prepended with a slash, eg. `/quit`.
|
||||
|
||||
In scripts and remote control, no slash is needed to perform the command, eg. `quit`.
|
||||
|
||||
> **ℹ️ NOTE: Some commands may not be documented yet or are defined in description of Chat Bots, use `/help` to list them all, or you can contribute to this page.**
|
||||
|
||||
### `animation`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Swing your main or off hand.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/animation <mainhand|offhand>
|
||||
```
|
||||
|
||||
### `bed`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to make the bot sleep easily, all about sleeping in one command.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `bed leave|sleep <x> <y> <z>|sleep <radius>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Leave a bed:
|
||||
|
||||
```
|
||||
/bed leave
|
||||
```
|
||||
|
||||
Sleep in a bed on 124 84 76:
|
||||
|
||||
```
|
||||
/bed sleep 124 84 76
|
||||
```
|
||||
|
||||
Sleep in a bed using relative coordinates:
|
||||
|
||||
```
|
||||
/bed sleep ~ ~ ~-2
|
||||
```
|
||||
|
||||
Automatically find a bed in radius of 50 blocks and sleep in it:
|
||||
|
||||
```
|
||||
/bed sleep 50
|
||||
```
|
||||
|
||||
### `bots`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/bots <list|unload <bot name|all>>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Unload a bot called CustomScript
|
||||
|
||||
```
|
||||
/bots unload CustomScript
|
||||
```
|
||||
|
||||
Unload all bots
|
||||
|
||||
```
|
||||
/bots unload all
|
||||
```
|
||||
|
||||
### `changeslot`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Change your selected slot in the hotbar.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/changeslot <1-9>
|
||||
```
|
||||
|
||||
### `chunk`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Displays the chunk loading status in a nice way.
|
||||
|
||||
> **⚠️ WARNING: To use this feature you need to enable the [Terrain and Movements](configuration.md#terrainandmovements)**
|
||||
|
||||
> **ℹ️ NOTE: You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: [`enableemoji`](configuration.md#enableemoji)**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/chunk status [chunkX chunkZ|locationX locationY locationZ]
|
||||
```
|
||||
|
||||
How it looks:
|
||||
|
||||
|
||||
|
||||
### `dig`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Dig a block on a specific coordinate.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dig <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dig 127 63 12
|
||||
```
|
||||
|
||||
Using relative coordinates:
|
||||
|
||||
```
|
||||
/dig ~ ~-1 ~2
|
||||
```
|
||||
|
||||
### `dropitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Drop all items of a specific type from your inventory.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dropitem <itemtype>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All item types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs).**
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dropitem diamond
|
||||
```
|
||||
|
||||
### `entity`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Attack an entity, use an entity or get a list of entities around you.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Entity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/entity <id|entitytype> <attack|use>
|
||||
```
|
||||
|
||||
Get a list of entities around you:
|
||||
|
||||
```
|
||||
/entity
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All entity types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/EntityType.cs).**
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Attack a Zombie:
|
||||
|
||||
```
|
||||
/entity Zombie attack
|
||||
```
|
||||
|
||||
### `execif`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute a command if a specific condition is met.
|
||||
|
||||
The condition is a C# expression and the local variables you set using [`set`](#set), [`setrnd`](#setrnd) or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.
|
||||
|
||||
Also the instance of MCC is available with `MCC.`.
|
||||
|
||||
> **ℹ️ NOTE: All local variables are treated as strings in the app, when comparing their values, you can use `<variable> == "<value>"`, or better use [`.Equals`](https://www.programiz.com/csharp-programming/library/string/equals) method**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `/execif <condition (C# expression)> ---> <command>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Setting a variable and using it:
|
||||
|
||||
```
|
||||
/set test=Something
|
||||
/execif test == "Something" ---> send Success!
|
||||
```
|
||||
|
||||
```
|
||||
/set test2=1
|
||||
/execif test2 == "1" ---> send Success 2!
|
||||
```
|
||||
|
||||
|
||||
Basic C# expression:
|
||||
|
||||
```
|
||||
/execif 1 + 2 + 3 == 6 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using MCC class:
|
||||
|
||||
```
|
||||
/execif MCC.GetHealth() == 20.0 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using in combination with [`execmulti`](#execmulti):
|
||||
|
||||
```
|
||||
/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3
|
||||
```
|
||||
|
||||
### `execmulti`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute multiple commands in succession on a single line, useful for debugging or when using [`execif`](#execif)
|
||||
|
||||
Commands are separated by `->`
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `execmulti <command 1> -> <command 2> -> <command 3> -> ...`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/execmulti send 1 -> send 2 -> send 3 -> sneak
|
||||
```
|
||||
|
||||
### `quit`
|
||||
|
||||
- **Alias:** `exit`
|
||||
- **Description:**
|
||||
|
||||
Disconnect from the server and close the application
|
||||
|
||||
### `reco`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Disconnect and reconnect to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reco [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `reload`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Reloads settings from MinecraftClient.ini and Chat Bots.
|
||||
|
||||
> **ℹ️ NOTE: Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reload
|
||||
```
|
||||
|
||||
### `connect`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Go to the given server and resume the script
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/connect <server> [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<server>` is either a server IP or a server alias defined in servers file, for more info check out [serverlist](configuration.html#serverlist)**
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `script`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Run a script containing a list of commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/script <script name>
|
||||
```
|
||||
|
||||
### `send`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Send a message or a command to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/send <text>
|
||||
```
|
||||
|
||||
### `respawn`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use this to respawn if you are dead (like clicking "respawn" in-game)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/respawn
|
||||
```
|
||||
|
||||
### `log`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Display some text in the console (useful for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/log <text>
|
||||
```
|
||||
|
||||
- Example:
|
||||
|
||||
```
|
||||
/log this is some text
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- **Description:**
|
||||
|
||||
List players logged in to the server (uses tab list info sent by server)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/list
|
||||
```
|
||||
|
||||
### `set`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a value which can be used as `%variable%` in further commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/set <variable>=<value>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/set abc=123
|
||||
```
|
||||
|
||||
### `setrnd`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a `%variable%` randomly to one of the provided values
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/setrnd <variable> string1 "\"string2\" string3"
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/setrnd <variable> -7to10
|
||||
```
|
||||
|
||||
(Set a `%variable%` to a number from -7 to 9)
|
||||
|
||||
### `sneak`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle sneaking.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/Sneak
|
||||
```
|
||||
|
||||
### `tps`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Get the server TPS (Ticks Per Second).
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/tps
|
||||
```
|
||||
|
||||
### `useitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use item in the hand, this can be used to do a right click on items which open menus on servers.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useitem
|
||||
```
|
||||
|
||||
### `useblock`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Place a block from a hand on a specific coordinate or open an inventory:
|
||||
|
||||
- chest/trap chest
|
||||
- furnace
|
||||
- brewing stand
|
||||
- dispenser/dropper
|
||||
- hopper
|
||||
- shulker
|
||||
- loom
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **ℹ️ NOTE: Not all inventories have a GUI representation in an ASCII art format.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useblock <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/useblock 43 72 7
|
||||
```
|
||||
|
||||
### `follow`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Make the bot follow a player.
|
||||
|
||||
> **ℹ️ NOTE: This command is avaliable only with [Follow Player](chat-bots.md#follow-player) Chat Bot enabled.**
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.** > **ℹ️ NOTE: You need to have [Enity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/follow <player name|stop>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/follow milutinke
|
||||
```
|
||||
|
||||
### `wait`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Wait X ticks (10 ticks = ~1 second. Only for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/wait <time>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/wait 20
|
||||
```
|
||||
|
||||
### `move`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for moving when terrain and movements feature is enabled.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Terrain and Movements](configuration.md#terrainandmovements) is currently not supported in `1.4.6 - 1.6`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Enable gravity
|
||||
|
||||
```
|
||||
/move gravity on
|
||||
```
|
||||
|
||||
Move to coordinates:
|
||||
|
||||
```
|
||||
/move 125 72 34
|
||||
```
|
||||
|
||||
Move to a center of a block:
|
||||
|
||||
```
|
||||
/move center
|
||||
```
|
||||
|
||||
### `look`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for looking at direction when terrain and movements is enabled
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/look <x y z|yaw pitch|up|down|east|west|north|south>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/look up
|
||||
```
|
||||
|
||||
```
|
||||
/look east
|
||||
```
|
||||
|
||||
### `inventory`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for inventory manipulation.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.
|
||||
|
||||
Inventory has slots and each one of them has an id.
|
||||
|
||||
> **ℹ️ NOTE: This command DOES NOT physically open a container (eg. chest), for that you need to use [`useblock`](#useblock) command first.**
|
||||
|
||||
An example of player inventory with annotated IDs in ASCII art and a list of items:
|
||||
|
||||
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: player and container can be simplified with p and c accordingly**
|
||||
|
||||
Actions:
|
||||
|
||||
- `click`
|
||||
- `shiftclick`
|
||||
- `drop`
|
||||
|
||||
Show/Preview items in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id>
|
||||
```
|
||||
|
||||
Click/Shift-Click on an item in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: The default click is left click**
|
||||
|
||||
Close an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> close
|
||||
```
|
||||
|
||||
Drop item(s) from an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id> drop <slot id> <number of items|all>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To drop all items from a slot, you can use:** `all`
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive <slot id> <item type> <amount>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete <slot id>
|
||||
```
|
||||
|
||||
Show all available inventories:
|
||||
|
||||
```
|
||||
/inventory inventories
|
||||
```
|
||||
|
||||
Search for an item of specified type in available inventories:
|
||||
|
||||
```
|
||||
/inventory search <item type>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Show player's inventory:
|
||||
|
||||
```
|
||||
/inventory player
|
||||
```
|
||||
|
||||
Show/Preview items in an inventory using an id:
|
||||
|
||||
```
|
||||
/inventory 3
|
||||
```
|
||||
|
||||
Click on an item in player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player click 36
|
||||
```
|
||||
|
||||
Right-Click on an item in slot number/id `4` in an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 click 4 right
|
||||
```
|
||||
|
||||
Close an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 close
|
||||
```
|
||||
|
||||
Drop a single item from a player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player drop 36 1
|
||||
```
|
||||
|
||||
Drop all items from a player's inventory in slot number/id `37`:
|
||||
|
||||
```
|
||||
/inventory player drop 37 all
|
||||
```
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive 36 diamondblock 64
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory in slot number/id `36` when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete 36
|
||||
```
|
||||
|
||||
Search for 10 Slime Blocks in available inventories:
|
||||
|
||||
```
|
||||
/inventory s SlimeBlock 10
|
||||
```
|
||||
|
||||
### `debug`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle debug messages, useful for chatbot developers.
|
||||
|
||||
### `help`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Show commands help.
|
||||
|
||||
> **ℹ️ NOTE: Use "/send /help" for server help**
|
||||
28
docs/da/README.md
Normal file
28
docs/da/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
home: true
|
||||
heroImage: /images/MCC_logo_with_edge.png
|
||||
tagline: 'Minecraft Console Client (MCC) is a lightweight open-source Minecraft Java client implemented in C#'
|
||||
actions:
|
||||
-
|
||||
text: Installation
|
||||
link: ./guide/installation.md
|
||||
type: primary
|
||||
-
|
||||
text: Learn More →
|
||||
link: ./guide/
|
||||
type: secondary
|
||||
actionText:
|
||||
actionLink:
|
||||
features:
|
||||
-
|
||||
title: Chat
|
||||
details: Chat with other people on the server
|
||||
-
|
||||
title: Automation
|
||||
details: Create bots to do automated tasks
|
||||
-
|
||||
title: Supported Versions
|
||||
details: 1.4 - 1.19.2
|
||||
footer: Made by MCC Team with ❤️
|
||||
---
|
||||
|
||||
163
docs/da/guide/README.md
Normal file
163
docs/da/guide/README.md
Normal file
|
|
@ -0,0 +1,163 @@
|
|||
# Introduction
|
||||
|
||||
- [About](#about)
|
||||
- [Quick Intro (YouTube Videos)](#quick-intro)
|
||||
- [Features](#features)
|
||||
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
||||
- [Getting Help](#getting-help)
|
||||
- [Submitting a bug report or an idea/feature-request](#bugs-ideas-feature-requests)
|
||||
- [Important notes on some features](#notes-on-some-features)
|
||||
- [Credits](#credits)
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source **Minecraft** TUI client for **Java edition** that allows you to connect to any Minecraft Java 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, as well as extensible C# API for creating Bots.
|
||||
|
||||
It was originally made by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
||||
|
||||
## Features
|
||||
|
||||
- Chat
|
||||
|
||||
- Send and receive chat messages
|
||||
- [Log chat history](chat-bots.md#chat-log)
|
||||
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
|
||||
- [Anti AFK](chat-bots.md#anti-afk)
|
||||
- [Auto Relog](chat-bots.md#auto-relog)
|
||||
- [Script Scheduler](chat-bots.md#script-scheduler)
|
||||
- [Remote Control](chat-bots.md#remote-control)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
- [Auto Attack](chat-bots.md#auto-attack)
|
||||
- [Auto Fishing](chat-bots.md#auto-fishing)
|
||||
- [Auto Eat](chat-bots.md#auto-eat)
|
||||
- [Auto Craft](chat-bots.md#auto-craft)
|
||||
- [Mailer Bot](chat-bots.md#mailer)
|
||||
- [Auto Drop](chat-bots.md#auto-drop)
|
||||
- [Replay Mod](chat-bots.md#replay-mod)
|
||||
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
||||
- [Docker Support](installation.md#using-docker)
|
||||
- [Inventory Handling](usage.md#inventory)
|
||||
- [Terrain Traversing](usage.md#move)
|
||||
- Entity Handling
|
||||
|
||||
_NOTE: Some of mentioned features are disabled by default and you will have to turn them on in the configuration file and some may require additional configuration on your part for your specific usage._
|
||||
|
||||
## Why Minecraft Console Client?
|
||||
|
||||
- Easy to use
|
||||
- Helpful community
|
||||
- Open-Source
|
||||
- Fast performance
|
||||
- Cross-Platform
|
||||
- Docker Support
|
||||
- 10 years of continuous development
|
||||
- Active contributors
|
||||
- Widely used
|
||||
|
||||
## Quick Intro
|
||||
|
||||
Don't have time to read through the documentation, we got you, our community has made some simple introduction videos about the **Minecraft Console Client**.
|
||||
|
||||
### The list of the tutorials:
|
||||
|
||||
Installation:
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
Using Commands, Scripts and other features:
|
||||
|
||||
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
||||
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
||||
|
||||
## Getting Help
|
||||
|
||||
MCC has a community that is willing to help, we have a Discussions section in out Git Hub repository.
|
||||
|
||||
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) to access it.
|
||||
|
||||
### Before getting help
|
||||
|
||||
- **Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!**
|
||||
- **Please be kind and patient, respect others as they're the ones using their time to help you**
|
||||
|
||||
## Bugs, Ideas, Feature Requests
|
||||
|
||||
Bug reporting, idea submitting or feature requesting are done in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [Github repository]([here](https://github.com/MCCTeam/Minecraft-Console-Client)).
|
||||
|
||||
Navigate to the Issues section, search for a bug, idea or a feature using the search option here in the documentation and in the `Issues` section on Git Hub before making your own.
|
||||
|
||||
If you haven't found anything similar, go ahead and click on the `New issue` button, then choose what you want to do.
|
||||
|
||||
If you're reporting a bug, please be descriptive as much as possible, try to explain how to re-create the bug, attack screenshots and logs, make sure that you have [`debugmessages`](configuration.me#debugmessages) set to `true` before sending a bug report or taking a screenshot.
|
||||
|
||||
### Before submitting
|
||||
|
||||
- **Please use the search option here or in the `Issues` section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!**
|
||||
- **Please be kind, patient and respect others. Thank you!**
|
||||
|
||||
## Notes on some features
|
||||
|
||||
### Inventory, Terrain and Entity Handling
|
||||
|
||||
Inventory handling is currently not supported in versions: `1.4.6 - 1.9`
|
||||
|
||||
Terrain handling is currently not supported in versions: `1.4.6 - 1.6`
|
||||
|
||||
Entity handling is currently not supported in versions: `1.4.6 - 1.9` (but `1.8` and `1.9` are being worked on, almost at the working state, only `EntityMetadata` packet remains to be fixed)
|
||||
|
||||
There features might not always be implemented in the latest version of the game, since they're often subjected to major changes by Mojang, and we need some time to figure out what has changed and to implement the required changes.
|
||||
|
||||
If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.
|
||||
|
||||
## Credits
|
||||
|
||||
_Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
||||
|
||||
Many features would not have been possible without the help of our talented community:
|
||||
|
||||
**Maintainers**
|
||||
|
||||
ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte
|
||||
|
||||
**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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
||||
|
||||
**Bug Hunters**
|
||||
|
||||
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, 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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
||||
|
||||
**Contributors**
|
||||
|
||||
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
||||
|
||||
**Libraries:**
|
||||
|
||||
Minecraft Console Client also borrows code from the following libraries:
|
||||
|
||||
| Name | Purpose | Author | License |
|
||||
| ----------- | ---------------- | ---------------- | ------- |
|
||||
| Biko | Proxy handling | Benton Stark | MIT |
|
||||
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
||||
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
||||
|
||||
## Disclaimer
|
||||
|
||||
Even if everything should work, we are not responsible for 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 from the source code.
|
||||
|
||||
Also, remember that when you connect to a server with this program, you will appear where you left the last time. This means that **you can die if you log in in an unsafe place on a survival server!** Use the script scheduler bot to send a teleport command after logging in.
|
||||
|
||||
We remind you that **you may get banned** by your server for using this program. Use accordingly with server rules.
|
||||
|
||||
## License
|
||||
|
||||
Minecraft Console Client is a totally free of charge, open source project. The source code is available at [Github Repository](https://github.com/MCCTeam/Minecraft-Console-Client)
|
||||
|
||||
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html) Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|
||||
1921
docs/da/guide/chat-bots.md
Normal file
1921
docs/da/guide/chat-bots.md
Normal file
File diff suppressed because it is too large
Load diff
1185
docs/da/guide/configuration.md
Normal file
1185
docs/da/guide/configuration.md
Normal file
File diff suppressed because it is too large
Load diff
76
docs/da/guide/contibuting.md
Normal file
76
docs/da/guide/contibuting.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# Contributing
|
||||
|
||||
At this moment this page needs to be created.
|
||||
|
||||
For now you can use our article from the [Git Hub repository Wiki](https://github.com/MCCTeam/Minecraft-Console-Client/wiki/Update-console-client-to-new-version) written by [ReinforceZwei](https://github.com/ReinforceZwei).
|
||||
|
||||
## Translations
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* **`en.ini` : English - English**
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
### Add new translation
|
||||
|
||||
1. First you need to get the name of the translated file.
|
||||
* Visit [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) and find the first occurrence of the language you need to translate in the table below.
|
||||
* Use the language code of the row in the table as the name of the translation file.
|
||||
* For example:
|
||||
* `English` -> row `English 0x0009` -> `en` -> `en.ini`
|
||||
* `Chinese (Traditional)` -> row `Chinese (Traditional) 0x7C04` -> `zh-Hant` -> `zh-Hant.ini`
|
||||
|
||||
2. Which system languages are recommended to use this translation?
|
||||
* Still check the table in [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c), one language may have multiple rows.
|
||||
* You will need to indicate which language codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `de.ini` applies to `de`, `de-AT`, `de-BE`, `de-DE`, ...
|
||||
* Translation `zh-Hans.ini` applies to `zh-Hans`, `zh`, `zh-CN`, `zh-SG`.
|
||||
|
||||
3. Which game languages are recommended to use this translation?
|
||||
* Check out the table in [this link](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239), where the `Locale Code` column indicates the language code in minecraft.
|
||||
* You will need to indicate which locale codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `fr.ini` applies to `fr_ca`, `fr_fr`.
|
||||
* Translation `zh-Hans.ini` applies to `zh_cn`.
|
||||
|
||||
4. Add the new translation to the code. (Optional)
|
||||
* **If you are not familiar with programming, you can skip this step and just write the above information in your PR or issue.**
|
||||
* Add the newly created translation file `xx.ini` to the project `/Resources/lang/xx.ini`.
|
||||
* Open `/DefaultConfigResource.resx`.
|
||||
* Click `Add Resources`.
|
||||
* Choose `/Resources/lang/xx.ini`.
|
||||
* Rename the added resource file in `/DefaultConfigResource.resx` to `Translation_xx`.
|
||||
* Open `/Translations.cs`.
|
||||
* Find `public static Tuple<string, string[]> GetTranslationPriority();`
|
||||
* Update the mapping of system language codes to translation files.
|
||||
* Find `public static string[] GetTranslationPriority(string gameLanguage);`
|
||||
* Update the mapping of game locale code to translation files.
|
||||
|
||||
5. Follow the section "Update existing translation".
|
||||
|
||||
### Update existing translation
|
||||
|
||||
1. Visit [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang), download `en.ini` and the language you want to translate(`xx.ini`).
|
||||
|
||||
2. Compare `en.ini` and `xx.ini` and update outdated or non-existent entries in `xx.ini`.
|
||||
|
||||
3. 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.
|
||||
|
||||
### Translate README.md
|
||||
|
||||
1. Get the English version of the README.md from [here](https://raw.githubusercontent.com/MCCTeam/Minecraft-Console-Client/master/README.md).
|
||||
|
||||
2. See `Add new translation -> 1.` for the target language code. Assume it is `xx`.
|
||||
|
||||
3. Complete the translation according to the English README.md and name the translated version as `README-xx.md`.
|
||||
|
||||
4. In the English README, above the "About" section, add the name of the language and a hyperlink to `README-xx.md`.
|
||||
|
||||
## Contributors
|
||||
|
||||
[Check out our contributors on Github](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors).
|
||||
170
docs/da/guide/creating-bots.md
Normal file
170
docs/da/guide/creating-bots.md
Normal file
|
|
@ -0,0 +1,170 @@
|
|||
# Creating Chat Bots
|
||||
|
||||
- [Notes](#notes)
|
||||
- [Requirements](#requirements)
|
||||
- [Quick Introduction](#quick-introduction)
|
||||
- [Examples](#examples)
|
||||
- [C# API](#c#-api)
|
||||
|
||||
## Notes
|
||||
|
||||
> **ℹ️ NOTE: For now this page contains only the bare basics of the Chat Bot API, enough of details to teach you how to make basic Chat Bots. For more details you need to take a look at the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) and [Examples](#examples). This page will be improved in the future.**
|
||||
|
||||
**Minecraft Console Client** has a rich C# API which allows you to create Chat Bots (effectively plugins) which can help you create complex automations which normal scripts may not be able to do.
|
||||
|
||||
## Requirements
|
||||
|
||||
- A basic knowledge of C# programming language
|
||||
- A text editor
|
||||
|
||||
If you're not familiar with the C# programming language, we suggest taking a look at the following resources:
|
||||
|
||||
Crash courses:
|
||||
|
||||
- [C# Crash Course playlist by Teddy Smit](https://www.youtube.com/watch?v=67oWw9TanOk&list=PL82C6-O4XrHfoN_Y4MwGvJz5BntiL0z0D)
|
||||
|
||||
More in-depth:
|
||||
|
||||
- [Learn C# Youtube Playlist by Microsoft](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oVxKLQCHpiUWun7vlJJvUiN)
|
||||
- [Getting started with C# (An index of tutorials and the documentation) by Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/)
|
||||
|
||||
## Quick Introduction
|
||||
|
||||
This introduction assumes that you have the basic knowledge of C#.
|
||||
|
||||
> **ℹ️ NOTE: Here we will use terms Chat Bot and Script interchangeably**
|
||||
|
||||
Create a new empty file and name it `ExampleChatBot.cs` in the same folder where you have your MCC installed.
|
||||
|
||||
Paste the following example code:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
|
||||
// The code and comments above are defining a "Script Metadata" section
|
||||
|
||||
// Every single chat bot (script) must be a class which extends the ChatBot class.
|
||||
// Your class must be instantiates in the "Script Metadata" section and passed to MCC.LoadBot function.
|
||||
class ExampleChatBot : ChatBot
|
||||
{
|
||||
// This method will be called when the script has been initialized for the first time, it's called only once
|
||||
// Here you can initialize variables, eg. Dictionaries. etc...
|
||||
public override void Initialize()
|
||||
{
|
||||
LogToConsole("An example Chat Bot has been initialized!");
|
||||
}
|
||||
|
||||
// This is a function that will be run when we get a chat message from a server
|
||||
// In this example it just detects the type of the message and prints it out
|
||||
public override void GetText(string text)
|
||||
{
|
||||
string message = "";
|
||||
string username = "";
|
||||
text = GetVerbatim(text);
|
||||
|
||||
if (IsPrivateMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has sent you a private message: " + message);
|
||||
}
|
||||
else if (IsChatMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has said: " + message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Start MCC, connect to a server and run the following internal command: `/script ExampleChatBot.cs`.
|
||||
|
||||
If you did everything right you should see: `[Example Chat Bot] An example Chat Bot has been initialised!` message appear in your console log.
|
||||
|
||||
### Structure of Chat Bots
|
||||
|
||||
Chat Bot (Script) structure is the following:
|
||||
|
||||
```
|
||||
<script metadata>
|
||||
<chat bot class>
|
||||
```
|
||||
|
||||
**Script Metadata** is a section with a custom format that mixes in C# with our format using comments. Every single Chat Bot (Script) must have this section at the beginning in order to work.
|
||||
|
||||
### Script Metadata Format
|
||||
|
||||
`//MCCScript 1.0` marks the beginning of the **Script Metadata** section, this must always be on the first line or the Chat Bot (Script) will not load and will throw an error.
|
||||
|
||||
`//MCCScript Extensions` marks the end of the **Script Metadata** section, this must be defined before a Chat Bot (Script) class.
|
||||
|
||||
In order for your Chat Bot (Script) to properly load in-between the `//MCCScript 1.0` and the `//MCCScript Extensions` lines you must instantiate your Chat Bot (Script) class and pass it to the `MCC.LoadBot` function.
|
||||
|
||||
Example code:
|
||||
|
||||
```
|
||||
MCC.LoadBot(new YourChatBotClassNameHere());
|
||||
```
|
||||
|
||||
**Script Metadata** section allows for including C# packages and libraries with: `//using <namespace>` and `/dll <dll name>`.
|
||||
|
||||
> **ℹ️ NOTE: Avoid adding whitespace between `//` and keywords**
|
||||
|
||||
By the default the following packages are loaded:
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Text.RegularExpressions;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.IO;
|
||||
using System.Net;
|
||||
using System.Threading;
|
||||
using MinecraftClient;
|
||||
using MinecraftClient.Mapping;
|
||||
using MinecraftClient.Inventory;
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```csharp
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
```
|
||||
|
||||
Full Example:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
```
|
||||
|
||||
### Chat Bot Class
|
||||
|
||||
After the end of the **Script Metadata** section, you basically can define any number of classes you like, the only limitation is that the main class of your Chat Bot (Script) must extend `ChatBot` class.
|
||||
|
||||
There are no required methods, everything is optional.
|
||||
|
||||
When the Chat Bot (Script) has been initialized for the first time the `Initialize` method will be called. In it you can initialize variables, eg. Dictionaries, etc..
|
||||
|
||||
> **ℹ️ NOTE: For allocating resources like a database connection, we recommend allocating them in `AfterGameJoined` and freeing them in `OnDisconnect`**.
|
||||
|
||||
## Examples
|
||||
|
||||
You can find a lot of examples in our Git Hub Repository at [ChatBots](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/ChatBots) and [config](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config).
|
||||
|
||||
## C# API
|
||||
|
||||
As of the time of writing, the C# API has been changed in forks that are yet to be merged, so for now you can use the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) for reference.
|
||||
|
||||
Each method is well documented with standard C# documentation comments.
|
||||
|
||||
In the future we will make a script to auto-generate this section based on the documentation in the code.
|
||||
931
docs/da/guide/installation.md
Normal file
931
docs/da/guide/installation.md
Normal file
|
|
@ -0,0 +1,931 @@
|
|||
# Installation
|
||||
|
||||
- [YouTube Tutorials](#youtube-tutorials)
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker)
|
||||
- [Run on Android](#run-on-android)
|
||||
- [Run MCC 24/7 on a VPS](#run-on-a-vps)
|
||||
|
||||
## YouTube Tutorials
|
||||
|
||||
If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
## Download a compiled binary
|
||||
|
||||
In order to run **Minecraft Console Client** you need [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download)
|
||||
|
||||
> **⚠️ IMPORTANT: If you already have .NET, but an older version than `6.0`, please update to `6.0` since MCC might not work as expected or at all.**
|
||||
|
||||
#### How to install .NET on your platform
|
||||
|
||||
- [Install .NET on Windows](https://docs.microsoft.com/en-us/dotnet/core/install/windows)
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Download
|
||||
|
||||
You can download a compiled binary file of the latest build from our Releases section on Git Hub: [Download](https://github.com/MCCTeam/Minecraft-Console-Client/releases)
|
||||
|
||||
## Building from the source code
|
||||
|
||||
### Windows
|
||||
|
||||
Requirements:
|
||||
|
||||
- [Git](https://www.git-scm.com/)
|
||||
- [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
Install [Git](https://www.git-scm.com/)
|
||||
|
||||
1. Make a new folder where you want to keep the source code
|
||||
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
|
||||
3. Click on `Git Bash Here` in the context menu
|
||||
4. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
|
||||
6. Open up the new cloned folder
|
||||
|
||||
#### Building using the Visual Studio
|
||||
|
||||
1. Open up the `MinecraftClient.sln` via Visual Studio
|
||||
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
3. Click on `Properties`
|
||||
4. Open up the `Build` tab and select configuration `Release`
|
||||
5. Press `CTRL + S` and close the file
|
||||
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
7. Click `Build`
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
#### Building using .NET manually without Visual Studio
|
||||
|
||||
1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
|
||||
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
|
||||
3. Run the following command to build the project:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r win-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
### Linux, macOS
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
|
||||
- Linux:
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**
|
||||
|
||||
- [Install Git on macOS](https://git-scm.com/download/mac)
|
||||
|
||||
- .NET SDK 6.0 or new-er
|
||||
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
1. Open up a terminal emulator and navigate to the folder where you will store the MCC
|
||||
2. Recursively clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)
|
||||
4. Run the following command to build the project:
|
||||
|
||||
- On Linux:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r linux-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux that is either ARM, 32-bit, Rhel based, Using Musl, or Tirzen, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace the `'-r linux-64` with an appropriate `-r <your RID>` (Example for arm: `-r linux-arm64`)**
|
||||
|
||||
- On macOS:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r osx-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're not using MAC with Intel, find an appropriate RID for your ARM processor, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) and replace the `'-r osx-64` with an appropriate `-r <your RID>` (Example for arm: `-r osx.12-arm64`)**
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient` will be in:
|
||||
|
||||
- Linux: `MinecraftClient/bin/Release/net6.0/linux-x64/publish/`
|
||||
- macOS: `MinecraftClient/bin/Release/net6.0/osx-x64/publish/`
|
||||
|
||||
## Using Docker
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
- Docker
|
||||
|
||||
> **ℹ️ NOTE: This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**
|
||||
|
||||
> **⚠️ WARNING: Pay attention at warnings, Docker currently works, but you must start the containers in the interactive mode or MCC will crash, we're working on solving this.**
|
||||
|
||||
1. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
2. Navigate to `Minecraft-Console-Client/Docker`
|
||||
3. Build the image using the following command
|
||||
|
||||
```bash
|
||||
docker build -t minecraft-console-client:latest .
|
||||
```
|
||||
|
||||
**Start the container using Docker:**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: There is a bug with the ConsoleInteractive which causes a crash when a container is started in a headless mode, so you need to use the interactive mode. Do not restart containers in a classic way, stop then and start them with interactive mode (this command), after that simply detach with `CTRL + P` and then `CTRL + Q`.**
|
||||
|
||||
```bash
|
||||
# You could also ignore the -v parameter if you dont want to mount the volume that is up to you. If you don't it's harder to edit the .ini file if thats something you want to do
|
||||
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
|
||||
```
|
||||
|
||||
Now you could login and the Client is running. To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`. To reattach use the `docker attach` command.
|
||||
|
||||
**Start the container using docker-compose:**
|
||||
|
||||
By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.
|
||||
|
||||
If you don't want to map a volume, you have to comment out or delete the entire volumes section:
|
||||
|
||||
```yml
|
||||
#volumes:
|
||||
#- './data:/opt/data'
|
||||
```
|
||||
|
||||
Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:
|
||||
|
||||
```bash
|
||||
docker-compose run MCC
|
||||
```
|
||||
|
||||
Remember to remove the container after usage:
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
If you use the INI file and entered your data (username, password, server) there, you can start your container using
|
||||
|
||||
```bash
|
||||
docker-compose up
|
||||
docker-compose up -d #for deamonized running in the background
|
||||
```
|
||||
|
||||
Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`. As above, you can stop and remove the container using
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Run on Android
|
||||
|
||||
It is possible to run the Minecraft Console Client on Android through Termux and Ubuntu 22.04 in it, however it requires a manual setup with a lot of commands, be careful no to skip any steps. Note that this might take anywhere from 10 to 20 minutes or more to do depending on your technical knowledge level, Internet speed and CPU speed.
|
||||
|
||||
> **ℹ️ NOTE: This section is going to get a bit technical, I'll try my best to make everything as simple as possible. If you are having trouble following along or if you encounter any issues, feel free to open up a discussion on our Github repository page.**
|
||||
|
||||
> **ℹ️ NOTE: You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**
|
||||
|
||||
> **ℹ️ NOTE: Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**
|
||||
|
||||
### Installation
|
||||
|
||||
#### Termux
|
||||
|
||||
> **⚠️ IMPORTANT: The Play Store version of Termux is outdated and not supported, do not use it, use the the [Github one](https://github.com/termux/termux-app/releases/latest/).**
|
||||
|
||||
Go to [the Termux Github latest release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it and run it.
|
||||
|
||||
> **ℹ️ NOTE: If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!**
|
||||
|
||||
#### Installing Ubuntu 22.04
|
||||
|
||||
At this stage, you have 2 options:
|
||||
|
||||
1. Following this textual tutorial
|
||||
2. Watching a [Youtube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM)
|
||||
|
||||
> **ℹ️ NOTE: If you decide to watch the Youtube tutorial, watch only up to `1:58`, the steps after are not needed and might just confuse you.**
|
||||
|
||||
In order to install Ubuntu 22.04 in Termux you require `wget` and `proot`, we're going to install them in the next step.
|
||||
|
||||
Once you have Termux installed open it up and run the following command one after other (in order):
|
||||
|
||||
1. `pkg update`
|
||||
2. `pkg upgrade`
|
||||
3. `pkg install proot wget`
|
||||
|
||||
> **ℹ️ NOTE: If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter**
|
||||
|
||||
Then you need to download an installation script using the following command:
|
||||
|
||||
```bash
|
||||
wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh
|
||||
```
|
||||
|
||||
Once the script has downloaded, run it with:
|
||||
|
||||
```bash
|
||||
bash ubuntu.sh
|
||||
```
|
||||
|
||||
Then you will be asked a question, enter `Y` and press `Enter`. Once the installation is complete, you can start Ubuntu with:
|
||||
|
||||
```bash
|
||||
./startubuntu.sh
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command**
|
||||
|
||||
#### Installing .NET on ARM
|
||||
|
||||
Since there are issues installing .NET 6.0 via the APT package manager at the time of writing, we will have to install it manually.
|
||||
|
||||
First we need to update the APT package manager repositories and install dependencies.
|
||||
|
||||
To update the APT repositories, run the following command:
|
||||
|
||||
```bash
|
||||
apt update -y && apt upgrade -y
|
||||
```
|
||||
|
||||
After you did it, we need to install dependencies for .NET, with the following command:
|
||||
|
||||
```bash
|
||||
apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y
|
||||
```
|
||||
|
||||
After you have installed dependencies, it's time to install .NET, you either can follow this tutorial or the [Microsoft one](https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install).
|
||||
|
||||
Navigate to your `/root` home directory with the following command:
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
```
|
||||
|
||||
First you need to download .NET 6.0, you can do it with the following command:
|
||||
|
||||
```bash
|
||||
wget https://download.visualstudio.microsoft.com/download/pr/901f7928-5479-4d32-a9e5-ba66162ca0e4/d00b935ec4dc79a27f5bde00712ed3d7/dotnet-sdk-6.0.400-linux-arm64.tar.gz
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you have 64 bit version of ARM processor, if you happen to have a 32-bit version replace the link in the command above with [this one](https://download.visualstudio.microsoft.com/download/pr/cf567026-a29a-41aa-bc3a-e4e1ad0df480/0925d411e8e09e31ba7a39a3eb0e29af/aspnetcore-runtime-6.0.8-linux-arm.tar.gz)**.
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you're following along and using Ubuntu 22.04, if you're using a different distro, like Alpine, go to [here](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) and copy an appropriate link for your distro.**
|
||||
|
||||
Once the file has been downloaded, you need to run the following commands in order:
|
||||
|
||||
1. `DOTNET_FILE=dotnet-sdk-6.0.400-linux-arm64.tar.gz`
|
||||
|
||||
> **⚠️ IMPORTANT: If you're using a different download link, update the file name in this command to match your version.**
|
||||
|
||||
2. `export DOTNET_ROOT=/root/.dotnet`
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"`
|
||||
4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools`
|
||||
|
||||
Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located.
|
||||
|
||||
> **⚠️ IMPORTANT: You will need a basic knowledge of Nano text editor, if you do not know how to use it, watch this [Youtube video tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A)**
|
||||
|
||||
To enable this, we need to edit our `/root/.bashrc` file with the following command:
|
||||
|
||||
```bash
|
||||
nano /root/.bashrc
|
||||
```
|
||||
|
||||
Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text:
|
||||
|
||||
```bash
|
||||
export DOTNET_ROOT=/root/.dotnet/
|
||||
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
|
||||
```
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter.
|
||||
|
||||
Veryfy that .NET was installed correctly by running:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get a help page:
|
||||
|
||||
```bash
|
||||
root@localhost:~# dotnet
|
||||
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
#### Installing MCC
|
||||
|
||||
Finally, we can install MCC.
|
||||
|
||||
> **⚠️ IMPORTANT: If you have a 32 ARM processor, you need to build the MCC yourself, take a look at the [Building From Source](#building-from-the-source-code) section. Also make sure to be using the appropriate `-r` parameter value for your architecture.**
|
||||
|
||||
Let's make a folder where the MCC will be stored with the following command:
|
||||
|
||||
```bash
|
||||
mkdir MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Then enter it the newly created folder:
|
||||
|
||||
```bash
|
||||
cd MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Download the MCC with the following command:
|
||||
|
||||
```bash
|
||||
wget https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest/download/MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
Unzip it with the following command:
|
||||
|
||||
```bash
|
||||
unzip MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
You can remove the zip archive now, we do not need it anymore, with:
|
||||
|
||||
```bash
|
||||
rm MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
And finally run it with:
|
||||
|
||||
```
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
#### After installation
|
||||
|
||||
When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh`
|
||||
|
||||
Then you can start the MCC again with `./MinecraftClient`
|
||||
|
||||
To stop MCC from running you can press `CTRL + C`
|
||||
|
||||
To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use, if you have followed the installation steps above, you should be familiar with it, if not, check out [this tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).
|
||||
|
||||
For downloading files, you can use the `wget` file we have installed, simply run: `wget your_link_here` (you have examples above, and a video tutorial down bellow).
|
||||
|
||||
Also, here are some linux tutorials for people who are new to it:
|
||||
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
## Run on a VPS
|
||||
|
||||
> **ℹ️ NOTE: This is a new section, if you find a mistake, please report it by opening an Issue in our [Github repository](https://github.com/MCCTeam/Minecraft-Console-Client). Thank you!**
|
||||
|
||||
The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.
|
||||
|
||||
- [What is a VPS?](#what-is-a-vps)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Where to get a VPS](#where-to-get-a-vps)
|
||||
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
|
||||
- [Initial VPS setup](#initial-vps-setup)
|
||||
- [Creating a new user account](#creating-a-new-user)
|
||||
- [Installing .NET Core 6](#installing-net-core-6)
|
||||
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)
|
||||
|
||||
### What is a VPS?
|
||||
|
||||
VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).
|
||||
|
||||
You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.
|
||||
|
||||
Here is a [Youtube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you're interested.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. Gitbash (if you're on Windows)
|
||||
|
||||
Download and install [Gitbash](https://git-scm.com/downloads).
|
||||
|
||||
> **ℹ️ NOTE: Make sure to allow the installation to add it to the context menu**
|
||||
|
||||
2. `ssh` and `ssh-keygen` commands (On Windows they're available with Gitbash, on macOs and Linux they should be available by default, it not, search on how to install them)
|
||||
|
||||
3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.
|
||||
|
||||
If you already know this, feel free to skip.
|
||||
|
||||
if you get stuck, watch those tutorials.
|
||||
|
||||
If you're new to this, you can learn about it here:
|
||||
|
||||
- [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
### Where to get a VPS
|
||||
|
||||
You have 2 options:
|
||||
|
||||
- [Buying a VPS](#buying-a-vps)
|
||||
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)
|
||||
|
||||
#### Buying a VPS
|
||||
|
||||
If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.
|
||||
|
||||
**What hardware requirements I need for running the MCC?**
|
||||
|
||||
The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.
|
||||
|
||||
**Where to buy a VPS?**
|
||||
|
||||
> **⚠️ VERY IMPORTANT: In this tutorial we will be using `Ubuntu 22.04`, make sure to select it as the OS when buying a VPS.**
|
||||
|
||||
Some of the reliable and cheap hosting providers (sorted for price/performance):
|
||||
|
||||
- [E-Trail](https://e-trail.net/vps)
|
||||
|
||||
**Minimum price**: `2.50 EUR / month`
|
||||
|
||||
> **ℹ️ NOTE: Does not have Ubuntu 22.04 in the dropdown menu when ordering, you will have to re-install later or ask support to do it.**
|
||||
|
||||
- [OVH Cloud](https://www.ovhcloud.com/de/vps/)
|
||||
|
||||
**Minimum price**: `3.57 EUR / month`
|
||||
|
||||
- [Hetzner Cloud](https://www.hetzner.com/cloud)
|
||||
|
||||
**Minimum price**: `4.51 EUR / month`
|
||||
|
||||
- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)
|
||||
|
||||
**Minimum price**: `4 EUR / month`
|
||||
|
||||
- [Contabo](https://contabo.com/en/vps/)
|
||||
|
||||
**Minimum price**: `7 EUR / month`
|
||||
|
||||
**More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**
|
||||
|
||||
You also may want to search for better deals.
|
||||
|
||||
#### AWS EC2 VPS
|
||||
|
||||
> **⚠️ VERY IMPORTANT: This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**
|
||||
|
||||
> **⚠️ WARNING: Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**
|
||||
|
||||
> **⚠️ WARNING: Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**
|
||||
|
||||
> **ℹ️ NOTE: If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**
|
||||
|
||||
Register on AWS and enter all of your billing info and a phone number. Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).
|
||||
|
||||
### Initial Amazon VPS setup
|
||||
|
||||
> **ℹ️ NOTE: Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**
|
||||
|
||||
When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`
|
||||
|
||||
> **ℹ️ NOTE: Make sure to select the region closest to you for the minimal latency**
|
||||
|
||||
Click on the **Launch instance** button.
|
||||
|
||||
Fill out the `Name` field with a name of your preference.
|
||||
|
||||
|
||||
|
||||
For the **Application and OS images** select `Ubuntu Server 22.04 LTS (HVM), SSD Volume Type`.
|
||||
|
||||
> **⚠️ VERY IMPORTANT: Make sure that it has `Free tier eligible` next to it.**
|
||||
|
||||
|
||||
|
||||
For the **Instance type** select `t2.micro`.
|
||||
|
||||
For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.
|
||||
|
||||
> **⚠️ EXTREMELY IMPORTANT: Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**
|
||||
|
||||
|
||||
|
||||
For the **Network settings** check the following checkboxes on:
|
||||
|
||||
- `Allow SSH traffic from` (Anywhere)
|
||||
- `Allow HTTPs traffic from the internet`
|
||||
- `Allow HTTP traffic from the internet`
|
||||
|
||||
> **ℹ️ NOTE: The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**
|
||||
|
||||
|
||||
|
||||
For the **Storage** enter `30`.
|
||||
|
||||
|
||||
|
||||
Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.
|
||||
|
||||
Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.
|
||||
|
||||
You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
In order to login with SSH, you are going to use the following command:
|
||||
|
||||
```bash
|
||||
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<` and `>` are not typed, that is just a notation for a placeholder!**
|
||||
|
||||
> **ℹ️ NOTE: `ubuntu` is a default root account username for Ubuntu on AWS!**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
|
||||
```
|
||||
|
||||
If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.
|
||||
|
||||
Now you can continue to [Creating a new user](#creating-a-new-user)
|
||||
|
||||
### Initial VPS setup
|
||||
|
||||
> **ℹ️ NOTE: This section if for those who do not use AWS, if you use AWS skip it**
|
||||
|
||||
When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.
|
||||
|
||||
Other option is that you will get your login info in the email once the setup is done.
|
||||
|
||||
Once you have the root login account info, you need [Gitbash](https://git-scm.com/downloads) on Windows and `ssh` if you're on macOS or Linux (if you do not have it by some chance, search on how to install it, it is simple).
|
||||
|
||||
If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:
|
||||
|
||||
```bash
|
||||
ssh <username>@<ip>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh root@142.26.73.14
|
||||
```
|
||||
|
||||
Example with port:
|
||||
|
||||
```bash
|
||||
ssh -p 2233 root@142.26.73.14
|
||||
```
|
||||
|
||||
Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.
|
||||
|
||||
### Creating a new user
|
||||
|
||||
Once you've logged in to your VPS you need to create a new user and give it SSH access.
|
||||
|
||||
In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.
|
||||
|
||||
> **ℹ️ NOTE: You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**
|
||||
|
||||
To create a new user named `mcc` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo useradd mcc -m
|
||||
```
|
||||
|
||||
Now we need to give it a password, execute the following command, type the password and confirm it:
|
||||
|
||||
```bash
|
||||
sudo passwd mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: When you're typing a password it will not be displayed on the screen, but you're typing it for real.**
|
||||
|
||||
> **ℹ️ NOTE: Make sure you have a strong password!**
|
||||
|
||||
Now we need to give our user account the admin permissions:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG sudo mcc
|
||||
```
|
||||
|
||||
Now we are going to set it's shell to bash:
|
||||
|
||||
```bash
|
||||
sudo chsh mcc -s /bin/bash
|
||||
```
|
||||
|
||||
Now we need to log in as the `mcc` user:
|
||||
|
||||
```bash
|
||||
su mcc
|
||||
```
|
||||
|
||||
Fill in your password when asked.
|
||||
|
||||
Navigate to the `mcc` user home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Make a new `.ssh` directory:
|
||||
|
||||
```bash
|
||||
mkdir .ssh
|
||||
```
|
||||
|
||||
Enter it with:
|
||||
|
||||
```bash
|
||||
cd .ssh
|
||||
```
|
||||
|
||||
Make a new empty file named `authorized_keys`:
|
||||
|
||||
```bash
|
||||
touch authorized_keys
|
||||
```
|
||||
|
||||
Do no close the Git bash/Terminal emulator. On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account. Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
Type the following command:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t RSA -b 4096
|
||||
```
|
||||
|
||||
Enter the name of the key file to be: `MCC_Key`, press Enter.
|
||||
|
||||
When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.
|
||||
|
||||
This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.
|
||||
|
||||
Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.
|
||||
|
||||
Return to the Git Bash/Terminal emulator and execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install nano -y
|
||||
```
|
||||
|
||||
This will install the Nano editor on your VPS.
|
||||
|
||||
Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.
|
||||
|
||||
Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:
|
||||
|
||||
```bash
|
||||
pwd
|
||||
```
|
||||
|
||||
If it does not print `/home/mcc/.ssh`, navigate to it with:
|
||||
|
||||
```bash
|
||||
cd /home/mcc/.ssh
|
||||
```
|
||||
|
||||
Now you need to open the `authorized_keys` file with the nano editor:
|
||||
|
||||
```bash
|
||||
nano authorized_keys
|
||||
```
|
||||
|
||||
Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.
|
||||
|
||||
Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.
|
||||
|
||||
Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:
|
||||
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
```
|
||||
|
||||
Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.
|
||||
|
||||
Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.
|
||||
|
||||
Additionally for better security you can do the following:
|
||||
|
||||
- Set `PermitRootLogin` to `yes`
|
||||
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
|
||||
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)
|
||||
|
||||
Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.
|
||||
|
||||
Now we need to restart the SSHD service with:
|
||||
|
||||
```bash
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
Let's check if everything is working correctly:
|
||||
|
||||
```bash
|
||||
sudo systemctl status sshd
|
||||
```
|
||||
|
||||
If everything has been configured as it should be you should see `active (running)` as a status of the service. If not, open the config file again and check for mistakes.
|
||||
|
||||
Press `q` to exit the log mode.
|
||||
|
||||
Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.
|
||||
|
||||
Now we can login to the user with our private `MCC_Key` file.
|
||||
|
||||
Command:
|
||||
|
||||
```bash
|
||||
ssh -i <path to the MCC_Key private key> mcc@<ip here>
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i MCC_Key mcc@3.71.108.69
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**
|
||||
|
||||
If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.
|
||||
|
||||
You can do `whoami` to see your username.
|
||||
|
||||
Now you can install .NET Core 6 and MCC.
|
||||
|
||||
### Installing .NET Core 6
|
||||
|
||||
> **ℹ️ NOTE: If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**
|
||||
|
||||
> **⚠️ WARNING: With newer versions of .NET Core 6 on Ubuntu 22.04 you might get the following error: `A fatal error occurred, the folder [/usr/share/dotnet/host/fxr] does not contain any version-numbered child folders`, if you get it, use [this solution](https://github.com/dotnet/sdk/issues/27082#issuecomment-1211143446)**
|
||||
|
||||
Log in as the user you've created.
|
||||
|
||||
Update the system packages and package manager repositories:
|
||||
|
||||
```bash
|
||||
sudo apt update -y && sudo apt upgrade -y
|
||||
```
|
||||
|
||||
Install `wget`:
|
||||
|
||||
```bash
|
||||
sudo apt install wget -y
|
||||
```
|
||||
|
||||
Go to your home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Download the Microsoft repository file:
|
||||
|
||||
```bash
|
||||
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Add Microsoft repositories to the package manager:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Remove the file, we do not need it anymore:
|
||||
|
||||
```bash
|
||||
rm packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Finally, install .NET Core 6:
|
||||
|
||||
```bash
|
||||
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-6.0
|
||||
```
|
||||
|
||||
Run the following command to check if everything was installed correctly:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get:
|
||||
|
||||
```
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
If you do not get this output and the installation was not successful, [try other methods](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu#2204).
|
||||
|
||||
If it was successful, you can now install the MCC.
|
||||
|
||||
### Installing MCC on a VPS
|
||||
|
||||
Now that you have .NET Core 6.0 and a user account, you should install the `screen` utility, you will need this in order to keep the MCC running once you close down the SSH session (if you do not have it, the MCC will just stop working once you disconnect). You can look at the `screen` like a window, except it's in a terminal, it lets you have multiple "windows" open at the same time.
|
||||
|
||||
> **ℹ️ NOTE: There is also a Docker method, if you're using Docker, you do not need the `screen` program.**
|
||||
|
||||
You also can learn about the screen command from [this Youtube tutorial](https://youtu.be/_ZJiEX4rmN4).
|
||||
|
||||
To install the `screen` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install screen -y
|
||||
```
|
||||
|
||||
Now you can install the MCC:
|
||||
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)
|
||||
|
||||
How to use the `screen` command?
|
||||
|
||||
> **⚠️ WARNING: If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**
|
||||
|
||||
To start a screen, type:
|
||||
|
||||
```bash
|
||||
screen -S mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**
|
||||
|
||||
> **ℹ️ NOTE: You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**
|
||||
|
||||
Now you will be in the screen, now you can start the MCC and detach from the screen.
|
||||
|
||||
To detach from the screen press `CTRL + A + D`.
|
||||
|
||||
To re-attach/return to the screen, execute the following command:
|
||||
|
||||
```bash
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:
|
||||
|
||||
```bash
|
||||
screen -d mcc
|
||||
```
|
||||
|
||||
To list out screens you can use:
|
||||
|
||||
```bash
|
||||
screen -ls
|
||||
```
|
||||
|
||||
To stop the MCC, you can hit `CTRL + D` (hit it few times).
|
||||
919
docs/da/guide/usage.md
Normal file
919
docs/da/guide/usage.md
Normal file
|
|
@ -0,0 +1,919 @@
|
|||
# Usage
|
||||
|
||||
How to run the program:
|
||||
|
||||
- [Running on Windows](#windows)
|
||||
- [Running on Linux, macOS](#linux-macos)
|
||||
- [Running using Docker](#docker)
|
||||
|
||||
Using the command line parameters:
|
||||
|
||||
- [Examples](#quick-usage-of-mcc-with-examples)
|
||||
- [Command line parameters](#command-line-parameters)
|
||||
- [Internal commands](#internal-commands)
|
||||
|
||||
## Windows
|
||||
|
||||
Simply run `MinecraftClient.exe`
|
||||
|
||||
> **ℹ️ NOTE: On Windows it's best using [Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/install) for the best experience and looks. Some features like emojis in the [`/chunk`](#chunk) command do not work in CMD or Powershell 5**
|
||||
|
||||
## Linux, macOS
|
||||
|
||||
To run the client you need to type the following command in your terminal emulator:
|
||||
|
||||
```bash
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
If you want to keep it running in the background you can use `screen` (Linux only) Example:
|
||||
|
||||
```bash
|
||||
# Start the screen
|
||||
screen -S mcc
|
||||
|
||||
# Run it
|
||||
./MinecraftClient
|
||||
|
||||
# Detach from the screen by pressing CTRL + A + D
|
||||
|
||||
# Re-attach if you want to have accces again
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
_Learn more on how to use the screen command: [YouTube](https://www.youtube.com/watch?v=_ZJiEX4rmN4)_
|
||||
|
||||
## Docker
|
||||
|
||||
See [Run using Docker](./guide/installation.md#using-docker)
|
||||
|
||||
## Command-line usage
|
||||
|
||||
**Minecraft Console Client** has a plethora of useful command line parameters, here you can learn about them.
|
||||
|
||||
### For people not familiar with the command line
|
||||
|
||||
For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.
|
||||
|
||||
In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.
|
||||
|
||||
Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:
|
||||
|
||||
- `someparameter`
|
||||
- `-some-parameter`
|
||||
- `--some-other-parameter`
|
||||
- `--some-setting="some value"`
|
||||
- `-a=5`
|
||||
|
||||
Parameters with a single dash (`-`) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (`--`) are being used for parameters with a longer/full name.
|
||||
|
||||
When you are reading examples, you will often see something like this: `<something here>`, this means that this is a place holder and it should be changed with some value, excluding the `<` and the `>`.
|
||||
|
||||
For example `<username>` you need to change to an username of your liking, example: `notch` (`<` and `>` should not be included).
|
||||
|
||||
`[` and `]` mean that a parameter is an optional one.
|
||||
|
||||
They also can hold some values, example from the MCC:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
```
|
||||
|
||||
When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes (`"`), example: `--some-parameter="some text here with spaces in it"`
|
||||
|
||||
Here is an example for using a `--help` command line parameter for MCC that will print out a page on how to use MCC from the command line:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
```
|
||||
|
||||
### Quick usage of MCC with examples
|
||||
|
||||
> **ℹ️ NOTE: On Linux and macOS, you need to type: `./MinecraftClient` instead of `MinecraftClient.exe`**
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
MinecraftClient.exe <username> <password> <server>
|
||||
MinecraftClient.exe <username> <password> <server> "/mycommand"
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
MinecraftClient.exe --section.setting=value [--other settings]
|
||||
MinecraftClient.exe <settings-file.ini> [--other settings]
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
|
||||
MinecraftClient.exe notch password123 mc.someserver.com:25565
|
||||
|
||||
# Overriding a setting from MinecraftClient.ini using a command line parameter
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
|
||||
# Providing a custom settings ini file and overriding a language to Chinese
|
||||
MinecraftClient.exe CustomSettingsFile.ini --language=zh
|
||||
```
|
||||
|
||||
### Rules of using the command line parameters
|
||||
|
||||
You can mix and match arguments by following theses rules:
|
||||
|
||||
- First positional argument may be either the login or a settings file
|
||||
- Other positional arguments are read in order: login, password, server, command
|
||||
- Arguments starting with `--` can be in any order and position
|
||||
|
||||
Examples and further explanations:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server>
|
||||
```
|
||||
|
||||
- This will automatically connect you to the chosen server.
|
||||
- You may omit password and/or server to specify e.g. only the login
|
||||
- To specify a server but ask password interactively, use `""` as password.
|
||||
- To specify offline mode with no password, use `-` as password.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server> "/mycommand"
|
||||
```
|
||||
|
||||
- This will automatically send `/mycommand` to the server and close.
|
||||
- To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini>
|
||||
```
|
||||
|
||||
- This will load the specified configuration file
|
||||
- If the file contains login / password / server ip, it will automatically connect.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
```
|
||||
|
||||
- Specify settings on the command-line, see possible value in the configuration file
|
||||
- Use `--section.setting=value` for settings outside the `[Main]` section
|
||||
- Example: `--antiafk.enabled=true` for enabling the `AntiAFK` bot
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]
|
||||
```
|
||||
|
||||
- Load the specified configuration file and override some settings from the file
|
||||
|
||||
## Internal Commands
|
||||
|
||||
These commands can be performed from the chat prompt, scripts or remote control.
|
||||
|
||||
From chat prompt, commands must by default be prepended with a slash, eg. `/quit`.
|
||||
|
||||
In scripts and remote control, no slash is needed to perform the command, eg. `quit`.
|
||||
|
||||
> **ℹ️ NOTE: Some commands may not be documented yet or are defined in description of Chat Bots, use `/help` to list them all, or you can contribute to this page.**
|
||||
|
||||
### `animation`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Swing your main or off hand.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/animation <mainhand|offhand>
|
||||
```
|
||||
|
||||
### `bed`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to make the bot sleep easily, all about sleeping in one command.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `bed leave|sleep <x> <y> <z>|sleep <radius>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Leave a bed:
|
||||
|
||||
```
|
||||
/bed leave
|
||||
```
|
||||
|
||||
Sleep in a bed on 124 84 76:
|
||||
|
||||
```
|
||||
/bed sleep 124 84 76
|
||||
```
|
||||
|
||||
Sleep in a bed using relative coordinates:
|
||||
|
||||
```
|
||||
/bed sleep ~ ~ ~-2
|
||||
```
|
||||
|
||||
Automatically find a bed in radius of 50 blocks and sleep in it:
|
||||
|
||||
```
|
||||
/bed sleep 50
|
||||
```
|
||||
|
||||
### `bots`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/bots <list|unload <bot name|all>>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Unload a bot called CustomScript
|
||||
|
||||
```
|
||||
/bots unload CustomScript
|
||||
```
|
||||
|
||||
Unload all bots
|
||||
|
||||
```
|
||||
/bots unload all
|
||||
```
|
||||
|
||||
### `changeslot`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Change your selected slot in the hotbar.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/changeslot <1-9>
|
||||
```
|
||||
|
||||
### `chunk`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Displays the chunk loading status in a nice way.
|
||||
|
||||
> **⚠️ WARNING: To use this feature you need to enable the [Terrain and Movements](configuration.md#terrainandmovements)**
|
||||
|
||||
> **ℹ️ NOTE: You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: [`enableemoji`](configuration.md#enableemoji)**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/chunk status [chunkX chunkZ|locationX locationY locationZ]
|
||||
```
|
||||
|
||||
How it looks:
|
||||
|
||||
|
||||
|
||||
### `dig`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Dig a block on a specific coordinate.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dig <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dig 127 63 12
|
||||
```
|
||||
|
||||
Using relative coordinates:
|
||||
|
||||
```
|
||||
/dig ~ ~-1 ~2
|
||||
```
|
||||
|
||||
### `dropitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Drop all items of a specific type from your inventory.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dropitem <itemtype>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All item types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs).**
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dropitem diamond
|
||||
```
|
||||
|
||||
### `entity`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Attack an entity, use an entity or get a list of entities around you.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Entity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/entity <id|entitytype> <attack|use>
|
||||
```
|
||||
|
||||
Get a list of entities around you:
|
||||
|
||||
```
|
||||
/entity
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All entity types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/EntityType.cs).**
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Attack a Zombie:
|
||||
|
||||
```
|
||||
/entity Zombie attack
|
||||
```
|
||||
|
||||
### `execif`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute a command if a specific condition is met.
|
||||
|
||||
The condition is a C# expression and the local variables you set using [`set`](#set), [`setrnd`](#setrnd) or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.
|
||||
|
||||
Also the instance of MCC is available with `MCC.`.
|
||||
|
||||
> **ℹ️ NOTE: All local variables are treated as strings in the app, when comparing their values, you can use `<variable> == "<value>"`, or better use [`.Equals`](https://www.programiz.com/csharp-programming/library/string/equals) method**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `/execif <condition (C# expression)> ---> <command>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Setting a variable and using it:
|
||||
|
||||
```
|
||||
/set test=Something
|
||||
/execif test == "Something" ---> send Success!
|
||||
```
|
||||
|
||||
```
|
||||
/set test2=1
|
||||
/execif test2 == "1" ---> send Success 2!
|
||||
```
|
||||
|
||||
|
||||
Basic C# expression:
|
||||
|
||||
```
|
||||
/execif 1 + 2 + 3 == 6 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using MCC class:
|
||||
|
||||
```
|
||||
/execif MCC.GetHealth() == 20.0 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using in combination with [`execmulti`](#execmulti):
|
||||
|
||||
```
|
||||
/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3
|
||||
```
|
||||
|
||||
### `execmulti`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute multiple commands in succession on a single line, useful for debugging or when using [`execif`](#execif)
|
||||
|
||||
Commands are separated by `->`
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `execmulti <command 1> -> <command 2> -> <command 3> -> ...`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/execmulti send 1 -> send 2 -> send 3 -> sneak
|
||||
```
|
||||
|
||||
### `quit`
|
||||
|
||||
- **Alias:** `exit`
|
||||
- **Description:**
|
||||
|
||||
Disconnect from the server and close the application
|
||||
|
||||
### `reco`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Disconnect and reconnect to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reco [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `reload`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Reloads settings from MinecraftClient.ini and Chat Bots.
|
||||
|
||||
> **ℹ️ NOTE: Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reload
|
||||
```
|
||||
|
||||
### `connect`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Go to the given server and resume the script
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/connect <server> [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<server>` is either a server IP or a server alias defined in servers file, for more info check out [serverlist](configuration.html#serverlist)**
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `script`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Run a script containing a list of commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/script <script name>
|
||||
```
|
||||
|
||||
### `send`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Send a message or a command to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/send <text>
|
||||
```
|
||||
|
||||
### `respawn`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use this to respawn if you are dead (like clicking "respawn" in-game)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/respawn
|
||||
```
|
||||
|
||||
### `log`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Display some text in the console (useful for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/log <text>
|
||||
```
|
||||
|
||||
- Example:
|
||||
|
||||
```
|
||||
/log this is some text
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- **Description:**
|
||||
|
||||
List players logged in to the server (uses tab list info sent by server)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/list
|
||||
```
|
||||
|
||||
### `set`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a value which can be used as `%variable%` in further commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/set <variable>=<value>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/set abc=123
|
||||
```
|
||||
|
||||
### `setrnd`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a `%variable%` randomly to one of the provided values
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/setrnd <variable> string1 "\"string2\" string3"
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/setrnd <variable> -7to10
|
||||
```
|
||||
|
||||
(Set a `%variable%` to a number from -7 to 9)
|
||||
|
||||
### `sneak`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle sneaking.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/Sneak
|
||||
```
|
||||
|
||||
### `tps`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Get the server TPS (Ticks Per Second).
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/tps
|
||||
```
|
||||
|
||||
### `useitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use item in the hand, this can be used to do a right click on items which open menus on servers.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useitem
|
||||
```
|
||||
|
||||
### `useblock`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Place a block from a hand on a specific coordinate or open an inventory:
|
||||
|
||||
- chest/trap chest
|
||||
- furnace
|
||||
- brewing stand
|
||||
- dispenser/dropper
|
||||
- hopper
|
||||
- shulker
|
||||
- loom
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **ℹ️ NOTE: Not all inventories have a GUI representation in an ASCII art format.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useblock <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/useblock 43 72 7
|
||||
```
|
||||
|
||||
### `follow`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Make the bot follow a player.
|
||||
|
||||
> **ℹ️ NOTE: This command is avaliable only with [Follow Player](chat-bots.md#follow-player) Chat Bot enabled.**
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.** > **ℹ️ NOTE: You need to have [Enity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/follow <player name|stop>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/follow milutinke
|
||||
```
|
||||
|
||||
### `wait`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Wait X ticks (10 ticks = ~1 second. Only for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/wait <time>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/wait 20
|
||||
```
|
||||
|
||||
### `move`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for moving when terrain and movements feature is enabled.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Terrain and Movements](configuration.md#terrainandmovements) is currently not supported in `1.4.6 - 1.6`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Enable gravity
|
||||
|
||||
```
|
||||
/move gravity on
|
||||
```
|
||||
|
||||
Move to coordinates:
|
||||
|
||||
```
|
||||
/move 125 72 34
|
||||
```
|
||||
|
||||
Move to a center of a block:
|
||||
|
||||
```
|
||||
/move center
|
||||
```
|
||||
|
||||
### `look`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for looking at direction when terrain and movements is enabled
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/look <x y z|yaw pitch|up|down|east|west|north|south>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/look up
|
||||
```
|
||||
|
||||
```
|
||||
/look east
|
||||
```
|
||||
|
||||
### `inventory`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for inventory manipulation.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.
|
||||
|
||||
Inventory has slots and each one of them has an id.
|
||||
|
||||
> **ℹ️ NOTE: This command DOES NOT physically open a container (eg. chest), for that you need to use [`useblock`](#useblock) command first.**
|
||||
|
||||
An example of player inventory with annotated IDs in ASCII art and a list of items:
|
||||
|
||||
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: player and container can be simplified with p and c accordingly**
|
||||
|
||||
Actions:
|
||||
|
||||
- `click`
|
||||
- `shiftclick`
|
||||
- `drop`
|
||||
|
||||
Show/Preview items in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id>
|
||||
```
|
||||
|
||||
Click/Shift-Click on an item in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: The default click is left click**
|
||||
|
||||
Close an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> close
|
||||
```
|
||||
|
||||
Drop item(s) from an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id> drop <slot id> <number of items|all>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To drop all items from a slot, you can use:** `all`
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive <slot id> <item type> <amount>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete <slot id>
|
||||
```
|
||||
|
||||
Show all available inventories:
|
||||
|
||||
```
|
||||
/inventory inventories
|
||||
```
|
||||
|
||||
Search for an item of specified type in available inventories:
|
||||
|
||||
```
|
||||
/inventory search <item type>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Show player's inventory:
|
||||
|
||||
```
|
||||
/inventory player
|
||||
```
|
||||
|
||||
Show/Preview items in an inventory using an id:
|
||||
|
||||
```
|
||||
/inventory 3
|
||||
```
|
||||
|
||||
Click on an item in player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player click 36
|
||||
```
|
||||
|
||||
Right-Click on an item in slot number/id `4` in an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 click 4 right
|
||||
```
|
||||
|
||||
Close an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 close
|
||||
```
|
||||
|
||||
Drop a single item from a player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player drop 36 1
|
||||
```
|
||||
|
||||
Drop all items from a player's inventory in slot number/id `37`:
|
||||
|
||||
```
|
||||
/inventory player drop 37 all
|
||||
```
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive 36 diamondblock 64
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory in slot number/id `36` when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete 36
|
||||
```
|
||||
|
||||
Search for 10 Slime Blocks in available inventories:
|
||||
|
||||
```
|
||||
/inventory s SlimeBlock 10
|
||||
```
|
||||
|
||||
### `debug`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle debug messages, useful for chatbot developers.
|
||||
|
||||
### `help`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Show commands help.
|
||||
|
||||
> **ℹ️ NOTE: Use "/send /help" for server help**
|
||||
28
docs/de/README.md
Normal file
28
docs/de/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
home: true
|
||||
heroImage: /images/MCC_logo_with_edge.png
|
||||
tagline: 'Minecraft Console Client (MCC) is a lightweight open-source Minecraft Java client implemented in C#'
|
||||
actions:
|
||||
-
|
||||
text: Installation
|
||||
link: ./guide/installation.md
|
||||
type: primary
|
||||
-
|
||||
text: Learn More →
|
||||
link: ./guide/
|
||||
type: secondary
|
||||
actionText:
|
||||
actionLink:
|
||||
features:
|
||||
-
|
||||
title: Chat
|
||||
details: Chat with other people on the server
|
||||
-
|
||||
title: Automation
|
||||
details: Create bots to do automated tasks
|
||||
-
|
||||
title: Supported Versions
|
||||
details: 1.4 - 1.19.2
|
||||
footer: Made by MCC Team with ❤️
|
||||
---
|
||||
|
||||
163
docs/de/guide/README.md
Normal file
163
docs/de/guide/README.md
Normal file
|
|
@ -0,0 +1,163 @@
|
|||
# Introduction
|
||||
|
||||
- [About](#about)
|
||||
- [Quick Intro (YouTube Videos)](#quick-intro)
|
||||
- [Features](#features)
|
||||
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
||||
- [Getting Help](#getting-help)
|
||||
- [Submitting a bug report or an idea/feature-request](#bugs-ideas-feature-requests)
|
||||
- [Important notes on some features](#notes-on-some-features)
|
||||
- [Credits](#credits)
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source **Minecraft** TUI client for **Java edition** that allows you to connect to any Minecraft Java 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, as well as extensible C# API for creating Bots.
|
||||
|
||||
It was originally made by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
||||
|
||||
## Features
|
||||
|
||||
- Chat
|
||||
|
||||
- Send and receive chat messages
|
||||
- [Log chat history](chat-bots.md#chat-log)
|
||||
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
|
||||
- [Anti AFK](chat-bots.md#anti-afk)
|
||||
- [Auto Relog](chat-bots.md#auto-relog)
|
||||
- [Script Scheduler](chat-bots.md#script-scheduler)
|
||||
- [Remote Control](chat-bots.md#remote-control)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
- [Auto Attack](chat-bots.md#auto-attack)
|
||||
- [Auto Fishing](chat-bots.md#auto-fishing)
|
||||
- [Auto Eat](chat-bots.md#auto-eat)
|
||||
- [Auto Craft](chat-bots.md#auto-craft)
|
||||
- [Mailer Bot](chat-bots.md#mailer)
|
||||
- [Auto Drop](chat-bots.md#auto-drop)
|
||||
- [Replay Mod](chat-bots.md#replay-mod)
|
||||
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
||||
- [Docker Support](installation.md#using-docker)
|
||||
- [Inventory Handling](usage.md#inventory)
|
||||
- [Terrain Traversing](usage.md#move)
|
||||
- Entity Handling
|
||||
|
||||
_NOTE: Some of mentioned features are disabled by default and you will have to turn them on in the configuration file and some may require additional configuration on your part for your specific usage._
|
||||
|
||||
## Why Minecraft Console Client?
|
||||
|
||||
- Easy to use
|
||||
- Helpful community
|
||||
- Open-Source
|
||||
- Fast performance
|
||||
- Cross-Platform
|
||||
- Docker Support
|
||||
- 10 years of continuous development
|
||||
- Active contributors
|
||||
- Widely used
|
||||
|
||||
## Quick Intro
|
||||
|
||||
Don't have time to read through the documentation, we got you, our community has made some simple introduction videos about the **Minecraft Console Client**.
|
||||
|
||||
### The list of the tutorials:
|
||||
|
||||
Installation:
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
Using Commands, Scripts and other features:
|
||||
|
||||
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
||||
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
||||
|
||||
## Getting Help
|
||||
|
||||
MCC has a community that is willing to help, we have a Discussions section in out Git Hub repository.
|
||||
|
||||
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) to access it.
|
||||
|
||||
### Before getting help
|
||||
|
||||
- **Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!**
|
||||
- **Please be kind and patient, respect others as they're the ones using their time to help you**
|
||||
|
||||
## Bugs, Ideas, Feature Requests
|
||||
|
||||
Bug reporting, idea submitting or feature requesting are done in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [Github repository]([here](https://github.com/MCCTeam/Minecraft-Console-Client)).
|
||||
|
||||
Navigate to the Issues section, search for a bug, idea or a feature using the search option here in the documentation and in the `Issues` section on Git Hub before making your own.
|
||||
|
||||
If you haven't found anything similar, go ahead and click on the `New issue` button, then choose what you want to do.
|
||||
|
||||
If you're reporting a bug, please be descriptive as much as possible, try to explain how to re-create the bug, attack screenshots and logs, make sure that you have [`debugmessages`](configuration.me#debugmessages) set to `true` before sending a bug report or taking a screenshot.
|
||||
|
||||
### Before submitting
|
||||
|
||||
- **Please use the search option here or in the `Issues` section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!**
|
||||
- **Please be kind, patient and respect others. Thank you!**
|
||||
|
||||
## Notes on some features
|
||||
|
||||
### Inventory, Terrain and Entity Handling
|
||||
|
||||
Inventory handling is currently not supported in versions: `1.4.6 - 1.9`
|
||||
|
||||
Terrain handling is currently not supported in versions: `1.4.6 - 1.6`
|
||||
|
||||
Entity handling is currently not supported in versions: `1.4.6 - 1.9` (but `1.8` and `1.9` are being worked on, almost at the working state, only `EntityMetadata` packet remains to be fixed)
|
||||
|
||||
There features might not always be implemented in the latest version of the game, since they're often subjected to major changes by Mojang, and we need some time to figure out what has changed and to implement the required changes.
|
||||
|
||||
If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.
|
||||
|
||||
## Credits
|
||||
|
||||
_Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
||||
|
||||
Many features would not have been possible without the help of our talented community:
|
||||
|
||||
**Maintainers**
|
||||
|
||||
ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte
|
||||
|
||||
**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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
||||
|
||||
**Bug Hunters**
|
||||
|
||||
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, 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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
||||
|
||||
**Contributors**
|
||||
|
||||
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
||||
|
||||
**Libraries:**
|
||||
|
||||
Minecraft Console Client also borrows code from the following libraries:
|
||||
|
||||
| Name | Purpose | Author | License |
|
||||
| ----------- | ---------------- | ---------------- | ------- |
|
||||
| Biko | Proxy handling | Benton Stark | MIT |
|
||||
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
||||
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
||||
|
||||
## Disclaimer
|
||||
|
||||
Even if everything should work, we are not responsible for 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 from the source code.
|
||||
|
||||
Also, remember that when you connect to a server with this program, you will appear where you left the last time. This means that **you can die if you log in in an unsafe place on a survival server!** Use the script scheduler bot to send a teleport command after logging in.
|
||||
|
||||
We remind you that **you may get banned** by your server for using this program. Use accordingly with server rules.
|
||||
|
||||
## License
|
||||
|
||||
Minecraft Console Client is a totally free of charge, open source project. The source code is available at [Github Repository](https://github.com/MCCTeam/Minecraft-Console-Client)
|
||||
|
||||
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html) Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|
||||
1921
docs/de/guide/chat-bots.md
Normal file
1921
docs/de/guide/chat-bots.md
Normal file
File diff suppressed because it is too large
Load diff
1185
docs/de/guide/configuration.md
Normal file
1185
docs/de/guide/configuration.md
Normal file
File diff suppressed because it is too large
Load diff
76
docs/de/guide/contibuting.md
Normal file
76
docs/de/guide/contibuting.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# Contributing
|
||||
|
||||
At this moment this page needs to be created.
|
||||
|
||||
For now you can use our article from the [Git Hub repository Wiki](https://github.com/MCCTeam/Minecraft-Console-Client/wiki/Update-console-client-to-new-version) written by [ReinforceZwei](https://github.com/ReinforceZwei).
|
||||
|
||||
## Translations
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* **`en.ini` : English - English**
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
### Add new translation
|
||||
|
||||
1. First you need to get the name of the translated file.
|
||||
* Visit [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) and find the first occurrence of the language you need to translate in the table below.
|
||||
* Use the language code of the row in the table as the name of the translation file.
|
||||
* For example:
|
||||
* `English` -> row `English 0x0009` -> `en` -> `en.ini`
|
||||
* `Chinese (Traditional)` -> row `Chinese (Traditional) 0x7C04` -> `zh-Hant` -> `zh-Hant.ini`
|
||||
|
||||
2. Which system languages are recommended to use this translation?
|
||||
* Still check the table in [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c), one language may have multiple rows.
|
||||
* You will need to indicate which language codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `de.ini` applies to `de`, `de-AT`, `de-BE`, `de-DE`, ...
|
||||
* Translation `zh-Hans.ini` applies to `zh-Hans`, `zh`, `zh-CN`, `zh-SG`.
|
||||
|
||||
3. Which game languages are recommended to use this translation?
|
||||
* Check out the table in [this link](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239), where the `Locale Code` column indicates the language code in minecraft.
|
||||
* You will need to indicate which locale codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `fr.ini` applies to `fr_ca`, `fr_fr`.
|
||||
* Translation `zh-Hans.ini` applies to `zh_cn`.
|
||||
|
||||
4. Add the new translation to the code. (Optional)
|
||||
* **If you are not familiar with programming, you can skip this step and just write the above information in your PR or issue.**
|
||||
* Add the newly created translation file `xx.ini` to the project `/Resources/lang/xx.ini`.
|
||||
* Open `/DefaultConfigResource.resx`.
|
||||
* Click `Add Resources`.
|
||||
* Choose `/Resources/lang/xx.ini`.
|
||||
* Rename the added resource file in `/DefaultConfigResource.resx` to `Translation_xx`.
|
||||
* Open `/Translations.cs`.
|
||||
* Find `public static Tuple<string, string[]> GetTranslationPriority();`
|
||||
* Update the mapping of system language codes to translation files.
|
||||
* Find `public static string[] GetTranslationPriority(string gameLanguage);`
|
||||
* Update the mapping of game locale code to translation files.
|
||||
|
||||
5. Follow the section "Update existing translation".
|
||||
|
||||
### Update existing translation
|
||||
|
||||
1. Visit [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang), download `en.ini` and the language you want to translate(`xx.ini`).
|
||||
|
||||
2. Compare `en.ini` and `xx.ini` and update outdated or non-existent entries in `xx.ini`.
|
||||
|
||||
3. 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.
|
||||
|
||||
### Translate README.md
|
||||
|
||||
1. Get the English version of the README.md from [here](https://raw.githubusercontent.com/MCCTeam/Minecraft-Console-Client/master/README.md).
|
||||
|
||||
2. See `Add new translation -> 1.` for the target language code. Assume it is `xx`.
|
||||
|
||||
3. Complete the translation according to the English README.md and name the translated version as `README-xx.md`.
|
||||
|
||||
4. In the English README, above the "About" section, add the name of the language and a hyperlink to `README-xx.md`.
|
||||
|
||||
## Contributors
|
||||
|
||||
[Check out our contributors on Github](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors).
|
||||
170
docs/de/guide/creating-bots.md
Normal file
170
docs/de/guide/creating-bots.md
Normal file
|
|
@ -0,0 +1,170 @@
|
|||
# Creating Chat Bots
|
||||
|
||||
- [Notes](#notes)
|
||||
- [Requirements](#requirements)
|
||||
- [Quick Introduction](#quick-introduction)
|
||||
- [Examples](#examples)
|
||||
- [C# API](#c#-api)
|
||||
|
||||
## Notes
|
||||
|
||||
> **ℹ️ NOTE: For now this page contains only the bare basics of the Chat Bot API, enough of details to teach you how to make basic Chat Bots. For more details you need to take a look at the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) and [Examples](#examples). This page will be improved in the future.**
|
||||
|
||||
**Minecraft Console Client** has a rich C# API which allows you to create Chat Bots (effectively plugins) which can help you create complex automations which normal scripts may not be able to do.
|
||||
|
||||
## Requirements
|
||||
|
||||
- A basic knowledge of C# programming language
|
||||
- A text editor
|
||||
|
||||
If you're not familiar with the C# programming language, we suggest taking a look at the following resources:
|
||||
|
||||
Crash courses:
|
||||
|
||||
- [C# Crash Course playlist by Teddy Smit](https://www.youtube.com/watch?v=67oWw9TanOk&list=PL82C6-O4XrHfoN_Y4MwGvJz5BntiL0z0D)
|
||||
|
||||
More in-depth:
|
||||
|
||||
- [Learn C# Youtube Playlist by Microsoft](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oVxKLQCHpiUWun7vlJJvUiN)
|
||||
- [Getting started with C# (An index of tutorials and the documentation) by Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/)
|
||||
|
||||
## Quick Introduction
|
||||
|
||||
This introduction assumes that you have the basic knowledge of C#.
|
||||
|
||||
> **ℹ️ NOTE: Here we will use terms Chat Bot and Script interchangeably**
|
||||
|
||||
Create a new empty file and name it `ExampleChatBot.cs` in the same folder where you have your MCC installed.
|
||||
|
||||
Paste the following example code:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
|
||||
// The code and comments above are defining a "Script Metadata" section
|
||||
|
||||
// Every single chat bot (script) must be a class which extends the ChatBot class.
|
||||
// Your class must be instantiates in the "Script Metadata" section and passed to MCC.LoadBot function.
|
||||
class ExampleChatBot : ChatBot
|
||||
{
|
||||
// This method will be called when the script has been initialized for the first time, it's called only once
|
||||
// Here you can initialize variables, eg. Dictionaries. etc...
|
||||
public override void Initialize()
|
||||
{
|
||||
LogToConsole("An example Chat Bot has been initialized!");
|
||||
}
|
||||
|
||||
// This is a function that will be run when we get a chat message from a server
|
||||
// In this example it just detects the type of the message and prints it out
|
||||
public override void GetText(string text)
|
||||
{
|
||||
string message = "";
|
||||
string username = "";
|
||||
text = GetVerbatim(text);
|
||||
|
||||
if (IsPrivateMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has sent you a private message: " + message);
|
||||
}
|
||||
else if (IsChatMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has said: " + message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Start MCC, connect to a server and run the following internal command: `/script ExampleChatBot.cs`.
|
||||
|
||||
If you did everything right you should see: `[Example Chat Bot] An example Chat Bot has been initialised!` message appear in your console log.
|
||||
|
||||
### Structure of Chat Bots
|
||||
|
||||
Chat Bot (Script) structure is the following:
|
||||
|
||||
```
|
||||
<script metadata>
|
||||
<chat bot class>
|
||||
```
|
||||
|
||||
**Script Metadata** is a section with a custom format that mixes in C# with our format using comments. Every single Chat Bot (Script) must have this section at the beginning in order to work.
|
||||
|
||||
### Script Metadata Format
|
||||
|
||||
`//MCCScript 1.0` marks the beginning of the **Script Metadata** section, this must always be on the first line or the Chat Bot (Script) will not load and will throw an error.
|
||||
|
||||
`//MCCScript Extensions` marks the end of the **Script Metadata** section, this must be defined before a Chat Bot (Script) class.
|
||||
|
||||
In order for your Chat Bot (Script) to properly load in-between the `//MCCScript 1.0` and the `//MCCScript Extensions` lines you must instantiate your Chat Bot (Script) class and pass it to the `MCC.LoadBot` function.
|
||||
|
||||
Example code:
|
||||
|
||||
```
|
||||
MCC.LoadBot(new YourChatBotClassNameHere());
|
||||
```
|
||||
|
||||
**Script Metadata** section allows for including C# packages and libraries with: `//using <namespace>` and `/dll <dll name>`.
|
||||
|
||||
> **ℹ️ NOTE: Avoid adding whitespace between `//` and keywords**
|
||||
|
||||
By the default the following packages are loaded:
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Text.RegularExpressions;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.IO;
|
||||
using System.Net;
|
||||
using System.Threading;
|
||||
using MinecraftClient;
|
||||
using MinecraftClient.Mapping;
|
||||
using MinecraftClient.Inventory;
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```csharp
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
```
|
||||
|
||||
Full Example:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
```
|
||||
|
||||
### Chat Bot Class
|
||||
|
||||
After the end of the **Script Metadata** section, you basically can define any number of classes you like, the only limitation is that the main class of your Chat Bot (Script) must extend `ChatBot` class.
|
||||
|
||||
There are no required methods, everything is optional.
|
||||
|
||||
When the Chat Bot (Script) has been initialized for the first time the `Initialize` method will be called. In it you can initialize variables, eg. Dictionaries, etc..
|
||||
|
||||
> **ℹ️ NOTE: For allocating resources like a database connection, we recommend allocating them in `AfterGameJoined` and freeing them in `OnDisconnect`**.
|
||||
|
||||
## Examples
|
||||
|
||||
You can find a lot of examples in our Git Hub Repository at [ChatBots](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/ChatBots) and [config](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config).
|
||||
|
||||
## C# API
|
||||
|
||||
As of the time of writing, the C# API has been changed in forks that are yet to be merged, so for now you can use the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) for reference.
|
||||
|
||||
Each method is well documented with standard C# documentation comments.
|
||||
|
||||
In the future we will make a script to auto-generate this section based on the documentation in the code.
|
||||
931
docs/de/guide/installation.md
Normal file
931
docs/de/guide/installation.md
Normal file
|
|
@ -0,0 +1,931 @@
|
|||
# Installation
|
||||
|
||||
- [YouTube Tutorials](#youtube-tutorials)
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker)
|
||||
- [Run on Android](#run-on-android)
|
||||
- [Run MCC 24/7 on a VPS](#run-on-a-vps)
|
||||
|
||||
## YouTube Tutorials
|
||||
|
||||
If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
## Download a compiled binary
|
||||
|
||||
In order to run **Minecraft Console Client** you need [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download)
|
||||
|
||||
> **⚠️ IMPORTANT: If you already have .NET, but an older version than `6.0`, please update to `6.0` since MCC might not work as expected or at all.**
|
||||
|
||||
#### How to install .NET on your platform
|
||||
|
||||
- [Install .NET on Windows](https://docs.microsoft.com/en-us/dotnet/core/install/windows)
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Download
|
||||
|
||||
You can download a compiled binary file of the latest build from our Releases section on Git Hub: [Download](https://github.com/MCCTeam/Minecraft-Console-Client/releases)
|
||||
|
||||
## Building from the source code
|
||||
|
||||
### Windows
|
||||
|
||||
Requirements:
|
||||
|
||||
- [Git](https://www.git-scm.com/)
|
||||
- [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
Install [Git](https://www.git-scm.com/)
|
||||
|
||||
1. Make a new folder where you want to keep the source code
|
||||
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
|
||||
3. Click on `Git Bash Here` in the context menu
|
||||
4. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
|
||||
6. Open up the new cloned folder
|
||||
|
||||
#### Building using the Visual Studio
|
||||
|
||||
1. Open up the `MinecraftClient.sln` via Visual Studio
|
||||
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
3. Click on `Properties`
|
||||
4. Open up the `Build` tab and select configuration `Release`
|
||||
5. Press `CTRL + S` and close the file
|
||||
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
7. Click `Build`
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
#### Building using .NET manually without Visual Studio
|
||||
|
||||
1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
|
||||
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
|
||||
3. Run the following command to build the project:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r win-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
### Linux, macOS
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
|
||||
- Linux:
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**
|
||||
|
||||
- [Install Git on macOS](https://git-scm.com/download/mac)
|
||||
|
||||
- .NET SDK 6.0 or new-er
|
||||
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
1. Open up a terminal emulator and navigate to the folder where you will store the MCC
|
||||
2. Recursively clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)
|
||||
4. Run the following command to build the project:
|
||||
|
||||
- On Linux:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r linux-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux that is either ARM, 32-bit, Rhel based, Using Musl, or Tirzen, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace the `'-r linux-64` with an appropriate `-r <your RID>` (Example for arm: `-r linux-arm64`)**
|
||||
|
||||
- On macOS:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r osx-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're not using MAC with Intel, find an appropriate RID for your ARM processor, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) and replace the `'-r osx-64` with an appropriate `-r <your RID>` (Example for arm: `-r osx.12-arm64`)**
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient` will be in:
|
||||
|
||||
- Linux: `MinecraftClient/bin/Release/net6.0/linux-x64/publish/`
|
||||
- macOS: `MinecraftClient/bin/Release/net6.0/osx-x64/publish/`
|
||||
|
||||
## Using Docker
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
- Docker
|
||||
|
||||
> **ℹ️ NOTE: This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**
|
||||
|
||||
> **⚠️ WARNING: Pay attention at warnings, Docker currently works, but you must start the containers in the interactive mode or MCC will crash, we're working on solving this.**
|
||||
|
||||
1. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
2. Navigate to `Minecraft-Console-Client/Docker`
|
||||
3. Build the image using the following command
|
||||
|
||||
```bash
|
||||
docker build -t minecraft-console-client:latest .
|
||||
```
|
||||
|
||||
**Start the container using Docker:**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: There is a bug with the ConsoleInteractive which causes a crash when a container is started in a headless mode, so you need to use the interactive mode. Do not restart containers in a classic way, stop then and start them with interactive mode (this command), after that simply detach with `CTRL + P` and then `CTRL + Q`.**
|
||||
|
||||
```bash
|
||||
# You could also ignore the -v parameter if you dont want to mount the volume that is up to you. If you don't it's harder to edit the .ini file if thats something you want to do
|
||||
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
|
||||
```
|
||||
|
||||
Now you could login and the Client is running. To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`. To reattach use the `docker attach` command.
|
||||
|
||||
**Start the container using docker-compose:**
|
||||
|
||||
By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.
|
||||
|
||||
If you don't want to map a volume, you have to comment out or delete the entire volumes section:
|
||||
|
||||
```yml
|
||||
#volumes:
|
||||
#- './data:/opt/data'
|
||||
```
|
||||
|
||||
Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:
|
||||
|
||||
```bash
|
||||
docker-compose run MCC
|
||||
```
|
||||
|
||||
Remember to remove the container after usage:
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
If you use the INI file and entered your data (username, password, server) there, you can start your container using
|
||||
|
||||
```bash
|
||||
docker-compose up
|
||||
docker-compose up -d #for deamonized running in the background
|
||||
```
|
||||
|
||||
Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`. As above, you can stop and remove the container using
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Run on Android
|
||||
|
||||
It is possible to run the Minecraft Console Client on Android through Termux and Ubuntu 22.04 in it, however it requires a manual setup with a lot of commands, be careful no to skip any steps. Note that this might take anywhere from 10 to 20 minutes or more to do depending on your technical knowledge level, Internet speed and CPU speed.
|
||||
|
||||
> **ℹ️ NOTE: This section is going to get a bit technical, I'll try my best to make everything as simple as possible. If you are having trouble following along or if you encounter any issues, feel free to open up a discussion on our Github repository page.**
|
||||
|
||||
> **ℹ️ NOTE: You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**
|
||||
|
||||
> **ℹ️ NOTE: Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**
|
||||
|
||||
### Installation
|
||||
|
||||
#### Termux
|
||||
|
||||
> **⚠️ IMPORTANT: The Play Store version of Termux is outdated and not supported, do not use it, use the the [Github one](https://github.com/termux/termux-app/releases/latest/).**
|
||||
|
||||
Go to [the Termux Github latest release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it and run it.
|
||||
|
||||
> **ℹ️ NOTE: If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!**
|
||||
|
||||
#### Installing Ubuntu 22.04
|
||||
|
||||
At this stage, you have 2 options:
|
||||
|
||||
1. Following this textual tutorial
|
||||
2. Watching a [Youtube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM)
|
||||
|
||||
> **ℹ️ NOTE: If you decide to watch the Youtube tutorial, watch only up to `1:58`, the steps after are not needed and might just confuse you.**
|
||||
|
||||
In order to install Ubuntu 22.04 in Termux you require `wget` and `proot`, we're going to install them in the next step.
|
||||
|
||||
Once you have Termux installed open it up and run the following command one after other (in order):
|
||||
|
||||
1. `pkg update`
|
||||
2. `pkg upgrade`
|
||||
3. `pkg install proot wget`
|
||||
|
||||
> **ℹ️ NOTE: If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter**
|
||||
|
||||
Then you need to download an installation script using the following command:
|
||||
|
||||
```bash
|
||||
wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh
|
||||
```
|
||||
|
||||
Once the script has downloaded, run it with:
|
||||
|
||||
```bash
|
||||
bash ubuntu.sh
|
||||
```
|
||||
|
||||
Then you will be asked a question, enter `Y` and press `Enter`. Once the installation is complete, you can start Ubuntu with:
|
||||
|
||||
```bash
|
||||
./startubuntu.sh
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command**
|
||||
|
||||
#### Installing .NET on ARM
|
||||
|
||||
Since there are issues installing .NET 6.0 via the APT package manager at the time of writing, we will have to install it manually.
|
||||
|
||||
First we need to update the APT package manager repositories and install dependencies.
|
||||
|
||||
To update the APT repositories, run the following command:
|
||||
|
||||
```bash
|
||||
apt update -y && apt upgrade -y
|
||||
```
|
||||
|
||||
After you did it, we need to install dependencies for .NET, with the following command:
|
||||
|
||||
```bash
|
||||
apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y
|
||||
```
|
||||
|
||||
After you have installed dependencies, it's time to install .NET, you either can follow this tutorial or the [Microsoft one](https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install).
|
||||
|
||||
Navigate to your `/root` home directory with the following command:
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
```
|
||||
|
||||
First you need to download .NET 6.0, you can do it with the following command:
|
||||
|
||||
```bash
|
||||
wget https://download.visualstudio.microsoft.com/download/pr/901f7928-5479-4d32-a9e5-ba66162ca0e4/d00b935ec4dc79a27f5bde00712ed3d7/dotnet-sdk-6.0.400-linux-arm64.tar.gz
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you have 64 bit version of ARM processor, if you happen to have a 32-bit version replace the link in the command above with [this one](https://download.visualstudio.microsoft.com/download/pr/cf567026-a29a-41aa-bc3a-e4e1ad0df480/0925d411e8e09e31ba7a39a3eb0e29af/aspnetcore-runtime-6.0.8-linux-arm.tar.gz)**.
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you're following along and using Ubuntu 22.04, if you're using a different distro, like Alpine, go to [here](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) and copy an appropriate link for your distro.**
|
||||
|
||||
Once the file has been downloaded, you need to run the following commands in order:
|
||||
|
||||
1. `DOTNET_FILE=dotnet-sdk-6.0.400-linux-arm64.tar.gz`
|
||||
|
||||
> **⚠️ IMPORTANT: If you're using a different download link, update the file name in this command to match your version.**
|
||||
|
||||
2. `export DOTNET_ROOT=/root/.dotnet`
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"`
|
||||
4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools`
|
||||
|
||||
Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located.
|
||||
|
||||
> **⚠️ IMPORTANT: You will need a basic knowledge of Nano text editor, if you do not know how to use it, watch this [Youtube video tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A)**
|
||||
|
||||
To enable this, we need to edit our `/root/.bashrc` file with the following command:
|
||||
|
||||
```bash
|
||||
nano /root/.bashrc
|
||||
```
|
||||
|
||||
Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text:
|
||||
|
||||
```bash
|
||||
export DOTNET_ROOT=/root/.dotnet/
|
||||
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
|
||||
```
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter.
|
||||
|
||||
Veryfy that .NET was installed correctly by running:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get a help page:
|
||||
|
||||
```bash
|
||||
root@localhost:~# dotnet
|
||||
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
#### Installing MCC
|
||||
|
||||
Finally, we can install MCC.
|
||||
|
||||
> **⚠️ IMPORTANT: If you have a 32 ARM processor, you need to build the MCC yourself, take a look at the [Building From Source](#building-from-the-source-code) section. Also make sure to be using the appropriate `-r` parameter value for your architecture.**
|
||||
|
||||
Let's make a folder where the MCC will be stored with the following command:
|
||||
|
||||
```bash
|
||||
mkdir MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Then enter it the newly created folder:
|
||||
|
||||
```bash
|
||||
cd MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Download the MCC with the following command:
|
||||
|
||||
```bash
|
||||
wget https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest/download/MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
Unzip it with the following command:
|
||||
|
||||
```bash
|
||||
unzip MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
You can remove the zip archive now, we do not need it anymore, with:
|
||||
|
||||
```bash
|
||||
rm MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
And finally run it with:
|
||||
|
||||
```
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
#### After installation
|
||||
|
||||
When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh`
|
||||
|
||||
Then you can start the MCC again with `./MinecraftClient`
|
||||
|
||||
To stop MCC from running you can press `CTRL + C`
|
||||
|
||||
To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use, if you have followed the installation steps above, you should be familiar with it, if not, check out [this tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).
|
||||
|
||||
For downloading files, you can use the `wget` file we have installed, simply run: `wget your_link_here` (you have examples above, and a video tutorial down bellow).
|
||||
|
||||
Also, here are some linux tutorials for people who are new to it:
|
||||
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
## Run on a VPS
|
||||
|
||||
> **ℹ️ NOTE: This is a new section, if you find a mistake, please report it by opening an Issue in our [Github repository](https://github.com/MCCTeam/Minecraft-Console-Client). Thank you!**
|
||||
|
||||
The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.
|
||||
|
||||
- [What is a VPS?](#what-is-a-vps)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Where to get a VPS](#where-to-get-a-vps)
|
||||
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
|
||||
- [Initial VPS setup](#initial-vps-setup)
|
||||
- [Creating a new user account](#creating-a-new-user)
|
||||
- [Installing .NET Core 6](#installing-net-core-6)
|
||||
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)
|
||||
|
||||
### What is a VPS?
|
||||
|
||||
VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).
|
||||
|
||||
You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.
|
||||
|
||||
Here is a [Youtube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you're interested.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. Gitbash (if you're on Windows)
|
||||
|
||||
Download and install [Gitbash](https://git-scm.com/downloads).
|
||||
|
||||
> **ℹ️ NOTE: Make sure to allow the installation to add it to the context menu**
|
||||
|
||||
2. `ssh` and `ssh-keygen` commands (On Windows they're available with Gitbash, on macOs and Linux they should be available by default, it not, search on how to install them)
|
||||
|
||||
3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.
|
||||
|
||||
If you already know this, feel free to skip.
|
||||
|
||||
if you get stuck, watch those tutorials.
|
||||
|
||||
If you're new to this, you can learn about it here:
|
||||
|
||||
- [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
### Where to get a VPS
|
||||
|
||||
You have 2 options:
|
||||
|
||||
- [Buying a VPS](#buying-a-vps)
|
||||
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)
|
||||
|
||||
#### Buying a VPS
|
||||
|
||||
If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.
|
||||
|
||||
**What hardware requirements I need for running the MCC?**
|
||||
|
||||
The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.
|
||||
|
||||
**Where to buy a VPS?**
|
||||
|
||||
> **⚠️ VERY IMPORTANT: In this tutorial we will be using `Ubuntu 22.04`, make sure to select it as the OS when buying a VPS.**
|
||||
|
||||
Some of the reliable and cheap hosting providers (sorted for price/performance):
|
||||
|
||||
- [E-Trail](https://e-trail.net/vps)
|
||||
|
||||
**Minimum price**: `2.50 EUR / month`
|
||||
|
||||
> **ℹ️ NOTE: Does not have Ubuntu 22.04 in the dropdown menu when ordering, you will have to re-install later or ask support to do it.**
|
||||
|
||||
- [OVH Cloud](https://www.ovhcloud.com/de/vps/)
|
||||
|
||||
**Minimum price**: `3.57 EUR / month`
|
||||
|
||||
- [Hetzner Cloud](https://www.hetzner.com/cloud)
|
||||
|
||||
**Minimum price**: `4.51 EUR / month`
|
||||
|
||||
- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)
|
||||
|
||||
**Minimum price**: `4 EUR / month`
|
||||
|
||||
- [Contabo](https://contabo.com/en/vps/)
|
||||
|
||||
**Minimum price**: `7 EUR / month`
|
||||
|
||||
**More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**
|
||||
|
||||
You also may want to search for better deals.
|
||||
|
||||
#### AWS EC2 VPS
|
||||
|
||||
> **⚠️ VERY IMPORTANT: This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**
|
||||
|
||||
> **⚠️ WARNING: Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**
|
||||
|
||||
> **⚠️ WARNING: Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**
|
||||
|
||||
> **ℹ️ NOTE: If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**
|
||||
|
||||
Register on AWS and enter all of your billing info and a phone number. Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).
|
||||
|
||||
### Initial Amazon VPS setup
|
||||
|
||||
> **ℹ️ NOTE: Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**
|
||||
|
||||
When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`
|
||||
|
||||
> **ℹ️ NOTE: Make sure to select the region closest to you for the minimal latency**
|
||||
|
||||
Click on the **Launch instance** button.
|
||||
|
||||
Fill out the `Name` field with a name of your preference.
|
||||
|
||||
|
||||
|
||||
For the **Application and OS images** select `Ubuntu Server 22.04 LTS (HVM), SSD Volume Type`.
|
||||
|
||||
> **⚠️ VERY IMPORTANT: Make sure that it has `Free tier eligible` next to it.**
|
||||
|
||||
|
||||
|
||||
For the **Instance type** select `t2.micro`.
|
||||
|
||||
For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.
|
||||
|
||||
> **⚠️ EXTREMELY IMPORTANT: Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**
|
||||
|
||||
|
||||
|
||||
For the **Network settings** check the following checkboxes on:
|
||||
|
||||
- `Allow SSH traffic from` (Anywhere)
|
||||
- `Allow HTTPs traffic from the internet`
|
||||
- `Allow HTTP traffic from the internet`
|
||||
|
||||
> **ℹ️ NOTE: The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**
|
||||
|
||||
|
||||
|
||||
For the **Storage** enter `30`.
|
||||
|
||||
|
||||
|
||||
Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.
|
||||
|
||||
Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.
|
||||
|
||||
You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
In order to login with SSH, you are going to use the following command:
|
||||
|
||||
```bash
|
||||
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<` and `>` are not typed, that is just a notation for a placeholder!**
|
||||
|
||||
> **ℹ️ NOTE: `ubuntu` is a default root account username for Ubuntu on AWS!**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
|
||||
```
|
||||
|
||||
If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.
|
||||
|
||||
Now you can continue to [Creating a new user](#creating-a-new-user)
|
||||
|
||||
### Initial VPS setup
|
||||
|
||||
> **ℹ️ NOTE: This section if for those who do not use AWS, if you use AWS skip it**
|
||||
|
||||
When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.
|
||||
|
||||
Other option is that you will get your login info in the email once the setup is done.
|
||||
|
||||
Once you have the root login account info, you need [Gitbash](https://git-scm.com/downloads) on Windows and `ssh` if you're on macOS or Linux (if you do not have it by some chance, search on how to install it, it is simple).
|
||||
|
||||
If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:
|
||||
|
||||
```bash
|
||||
ssh <username>@<ip>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh root@142.26.73.14
|
||||
```
|
||||
|
||||
Example with port:
|
||||
|
||||
```bash
|
||||
ssh -p 2233 root@142.26.73.14
|
||||
```
|
||||
|
||||
Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.
|
||||
|
||||
### Creating a new user
|
||||
|
||||
Once you've logged in to your VPS you need to create a new user and give it SSH access.
|
||||
|
||||
In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.
|
||||
|
||||
> **ℹ️ NOTE: You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**
|
||||
|
||||
To create a new user named `mcc` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo useradd mcc -m
|
||||
```
|
||||
|
||||
Now we need to give it a password, execute the following command, type the password and confirm it:
|
||||
|
||||
```bash
|
||||
sudo passwd mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: When you're typing a password it will not be displayed on the screen, but you're typing it for real.**
|
||||
|
||||
> **ℹ️ NOTE: Make sure you have a strong password!**
|
||||
|
||||
Now we need to give our user account the admin permissions:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG sudo mcc
|
||||
```
|
||||
|
||||
Now we are going to set it's shell to bash:
|
||||
|
||||
```bash
|
||||
sudo chsh mcc -s /bin/bash
|
||||
```
|
||||
|
||||
Now we need to log in as the `mcc` user:
|
||||
|
||||
```bash
|
||||
su mcc
|
||||
```
|
||||
|
||||
Fill in your password when asked.
|
||||
|
||||
Navigate to the `mcc` user home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Make a new `.ssh` directory:
|
||||
|
||||
```bash
|
||||
mkdir .ssh
|
||||
```
|
||||
|
||||
Enter it with:
|
||||
|
||||
```bash
|
||||
cd .ssh
|
||||
```
|
||||
|
||||
Make a new empty file named `authorized_keys`:
|
||||
|
||||
```bash
|
||||
touch authorized_keys
|
||||
```
|
||||
|
||||
Do no close the Git bash/Terminal emulator. On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account. Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
Type the following command:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t RSA -b 4096
|
||||
```
|
||||
|
||||
Enter the name of the key file to be: `MCC_Key`, press Enter.
|
||||
|
||||
When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.
|
||||
|
||||
This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.
|
||||
|
||||
Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.
|
||||
|
||||
Return to the Git Bash/Terminal emulator and execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install nano -y
|
||||
```
|
||||
|
||||
This will install the Nano editor on your VPS.
|
||||
|
||||
Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.
|
||||
|
||||
Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:
|
||||
|
||||
```bash
|
||||
pwd
|
||||
```
|
||||
|
||||
If it does not print `/home/mcc/.ssh`, navigate to it with:
|
||||
|
||||
```bash
|
||||
cd /home/mcc/.ssh
|
||||
```
|
||||
|
||||
Now you need to open the `authorized_keys` file with the nano editor:
|
||||
|
||||
```bash
|
||||
nano authorized_keys
|
||||
```
|
||||
|
||||
Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.
|
||||
|
||||
Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.
|
||||
|
||||
Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:
|
||||
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
```
|
||||
|
||||
Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.
|
||||
|
||||
Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.
|
||||
|
||||
Additionally for better security you can do the following:
|
||||
|
||||
- Set `PermitRootLogin` to `yes`
|
||||
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
|
||||
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)
|
||||
|
||||
Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.
|
||||
|
||||
Now we need to restart the SSHD service with:
|
||||
|
||||
```bash
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
Let's check if everything is working correctly:
|
||||
|
||||
```bash
|
||||
sudo systemctl status sshd
|
||||
```
|
||||
|
||||
If everything has been configured as it should be you should see `active (running)` as a status of the service. If not, open the config file again and check for mistakes.
|
||||
|
||||
Press `q` to exit the log mode.
|
||||
|
||||
Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.
|
||||
|
||||
Now we can login to the user with our private `MCC_Key` file.
|
||||
|
||||
Command:
|
||||
|
||||
```bash
|
||||
ssh -i <path to the MCC_Key private key> mcc@<ip here>
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i MCC_Key mcc@3.71.108.69
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**
|
||||
|
||||
If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.
|
||||
|
||||
You can do `whoami` to see your username.
|
||||
|
||||
Now you can install .NET Core 6 and MCC.
|
||||
|
||||
### Installing .NET Core 6
|
||||
|
||||
> **ℹ️ NOTE: If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**
|
||||
|
||||
> **⚠️ WARNING: With newer versions of .NET Core 6 on Ubuntu 22.04 you might get the following error: `A fatal error occurred, the folder [/usr/share/dotnet/host/fxr] does not contain any version-numbered child folders`, if you get it, use [this solution](https://github.com/dotnet/sdk/issues/27082#issuecomment-1211143446)**
|
||||
|
||||
Log in as the user you've created.
|
||||
|
||||
Update the system packages and package manager repositories:
|
||||
|
||||
```bash
|
||||
sudo apt update -y && sudo apt upgrade -y
|
||||
```
|
||||
|
||||
Install `wget`:
|
||||
|
||||
```bash
|
||||
sudo apt install wget -y
|
||||
```
|
||||
|
||||
Go to your home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Download the Microsoft repository file:
|
||||
|
||||
```bash
|
||||
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Add Microsoft repositories to the package manager:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Remove the file, we do not need it anymore:
|
||||
|
||||
```bash
|
||||
rm packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Finally, install .NET Core 6:
|
||||
|
||||
```bash
|
||||
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-6.0
|
||||
```
|
||||
|
||||
Run the following command to check if everything was installed correctly:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get:
|
||||
|
||||
```
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
If you do not get this output and the installation was not successful, [try other methods](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu#2204).
|
||||
|
||||
If it was successful, you can now install the MCC.
|
||||
|
||||
### Installing MCC on a VPS
|
||||
|
||||
Now that you have .NET Core 6.0 and a user account, you should install the `screen` utility, you will need this in order to keep the MCC running once you close down the SSH session (if you do not have it, the MCC will just stop working once you disconnect). You can look at the `screen` like a window, except it's in a terminal, it lets you have multiple "windows" open at the same time.
|
||||
|
||||
> **ℹ️ NOTE: There is also a Docker method, if you're using Docker, you do not need the `screen` program.**
|
||||
|
||||
You also can learn about the screen command from [this Youtube tutorial](https://youtu.be/_ZJiEX4rmN4).
|
||||
|
||||
To install the `screen` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install screen -y
|
||||
```
|
||||
|
||||
Now you can install the MCC:
|
||||
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)
|
||||
|
||||
How to use the `screen` command?
|
||||
|
||||
> **⚠️ WARNING: If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**
|
||||
|
||||
To start a screen, type:
|
||||
|
||||
```bash
|
||||
screen -S mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**
|
||||
|
||||
> **ℹ️ NOTE: You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**
|
||||
|
||||
Now you will be in the screen, now you can start the MCC and detach from the screen.
|
||||
|
||||
To detach from the screen press `CTRL + A + D`.
|
||||
|
||||
To re-attach/return to the screen, execute the following command:
|
||||
|
||||
```bash
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:
|
||||
|
||||
```bash
|
||||
screen -d mcc
|
||||
```
|
||||
|
||||
To list out screens you can use:
|
||||
|
||||
```bash
|
||||
screen -ls
|
||||
```
|
||||
|
||||
To stop the MCC, you can hit `CTRL + D` (hit it few times).
|
||||
919
docs/de/guide/usage.md
Normal file
919
docs/de/guide/usage.md
Normal file
|
|
@ -0,0 +1,919 @@
|
|||
# Benutzung
|
||||
|
||||
How to run the program:
|
||||
|
||||
- [Running on Windows](#windows)
|
||||
- [Running on Linux, macOS](#linux-macos)
|
||||
- [Running using Docker](#docker)
|
||||
|
||||
Using the command line parameters:
|
||||
|
||||
- [Examples](#quick-usage-of-mcc-with-examples)
|
||||
- [Command line parameters](#command-line-parameters)
|
||||
- [Internal commands](#internal-commands)
|
||||
|
||||
## Windows
|
||||
|
||||
Simply run `MinecraftClient.exe`
|
||||
|
||||
> **ℹ️ NOTE: On Windows it's best using [Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/install) for the best experience and looks. Some features like emojis in the [`/chunk`](#chunk) command do not work in CMD or Powershell 5**
|
||||
|
||||
## Linux, macOS
|
||||
|
||||
To run the client you need to type the following command in your terminal emulator:
|
||||
|
||||
```bash
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
If you want to keep it running in the background you can use `screen` (Linux only) Example:
|
||||
|
||||
```bash
|
||||
# Start the screen
|
||||
screen -S mcc
|
||||
|
||||
# Run it
|
||||
./MinecraftClient
|
||||
|
||||
# Detach from the screen by pressing CTRL + A + D
|
||||
|
||||
# Re-attach if you want to have accces again
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
_Learn more on how to use the screen command: [YouTube](https://www.youtube.com/watch?v=_ZJiEX4rmN4)_
|
||||
|
||||
## Docker
|
||||
|
||||
See [Run using Docker](./guide/installation.md#using-docker)
|
||||
|
||||
## Command-line usage
|
||||
|
||||
**Minecraft Console Client** has a plethora of useful command line parameters, here you can learn about them.
|
||||
|
||||
### For people not familiar with the command line
|
||||
|
||||
For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.
|
||||
|
||||
In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.
|
||||
|
||||
Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:
|
||||
|
||||
- `someparameter`
|
||||
- `-some-parameter`
|
||||
- `--some-other-parameter`
|
||||
- `--some-setting="some value"`
|
||||
- `-a=5`
|
||||
|
||||
Parameters with a single dash (`-`) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (`--`) are being used for parameters with a longer/full name.
|
||||
|
||||
When you are reading examples, you will often see something like this: `<something here>`, this means that this is a place holder and it should be changed with some value, excluding the `<` and the `>`.
|
||||
|
||||
For example `<username>` you need to change to an username of your liking, example: `notch` (`<` and `>` should not be included).
|
||||
|
||||
`[` and `]` mean that a parameter is an optional one.
|
||||
|
||||
They also can hold some values, example from the MCC:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
```
|
||||
|
||||
When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes (`"`), example: `--some-parameter="some text here with spaces in it"`
|
||||
|
||||
Here is an example for using a `--help` command line parameter for MCC that will print out a page on how to use MCC from the command line:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
```
|
||||
|
||||
### Quick usage of MCC with examples
|
||||
|
||||
> **ℹ️ NOTE: On Linux and macOS, you need to type: `./MinecraftClient` instead of `MinecraftClient.exe`**
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
MinecraftClient.exe <username> <password> <server>
|
||||
MinecraftClient.exe <username> <password> <server> "/mycommand"
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
MinecraftClient.exe --section.setting=value [--other settings]
|
||||
MinecraftClient.exe <settings-file.ini> [--other settings]
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
|
||||
MinecraftClient.exe notch password123 mc.someserver.com:25565
|
||||
|
||||
# Overriding a setting from MinecraftClient.ini using a command line parameter
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
|
||||
# Providing a custom settings ini file and overriding a language to Chinese
|
||||
MinecraftClient.exe CustomSettingsFile.ini --language=zh
|
||||
```
|
||||
|
||||
### Rules of using the command line parameters
|
||||
|
||||
You can mix and match arguments by following theses rules:
|
||||
|
||||
- First positional argument may be either the login or a settings file
|
||||
- Other positional arguments are read in order: login, password, server, command
|
||||
- Arguments starting with `--` can be in any order and position
|
||||
|
||||
Examples and further explanations:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server>
|
||||
```
|
||||
|
||||
- This will automatically connect you to the chosen server.
|
||||
- You may omit password and/or server to specify e.g. only the login
|
||||
- To specify a server but ask password interactively, use `""` as password.
|
||||
- To specify offline mode with no password, use `-` as password.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server> "/mycommand"
|
||||
```
|
||||
|
||||
- This will automatically send `/mycommand` to the server and close.
|
||||
- To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini>
|
||||
```
|
||||
|
||||
- This will load the specified configuration file
|
||||
- If the file contains login / password / server ip, it will automatically connect.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
```
|
||||
|
||||
- Specify settings on the command-line, see possible value in the configuration file
|
||||
- Use `--section.setting=value` for settings outside the `[Main]` section
|
||||
- Example: `--antiafk.enabled=true` for enabling the `AntiAFK` bot
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]
|
||||
```
|
||||
|
||||
- Load the specified configuration file and override some settings from the file
|
||||
|
||||
## Internal Commands
|
||||
|
||||
These commands can be performed from the chat prompt, scripts or remote control.
|
||||
|
||||
From chat prompt, commands must by default be prepended with a slash, eg. `/quit`.
|
||||
|
||||
In scripts and remote control, no slash is needed to perform the command, eg. `quit`.
|
||||
|
||||
> **ℹ️ NOTE: Some commands may not be documented yet or are defined in description of Chat Bots, use `/help` to list them all, or you can contribute to this page.**
|
||||
|
||||
### `animation`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Swing your main or off hand.
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/animation <mainhand|offhand>
|
||||
```
|
||||
|
||||
### `bed`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to make the bot sleep easily, all about sleeping in one command.
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
Basic usage: `bed leave|sleep <x> <y> <z>|sleep <radius>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Leave a bed:
|
||||
|
||||
```
|
||||
/bed leave
|
||||
```
|
||||
|
||||
Sleep in a bed on 124 84 76:
|
||||
|
||||
```
|
||||
/bed sleep 124 84 76
|
||||
```
|
||||
|
||||
Sleep in a bed using relative coordinates:
|
||||
|
||||
```
|
||||
/bed sleep ~ ~ ~-2
|
||||
```
|
||||
|
||||
Automatically find a bed in radius of 50 blocks and sleep in it:
|
||||
|
||||
```
|
||||
/bed sleep 50
|
||||
```
|
||||
|
||||
### `bots`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/bots <list|unload <bot name|all>>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Unload a bot called CustomScript
|
||||
|
||||
```
|
||||
/bots unload CustomScript
|
||||
```
|
||||
|
||||
Unload all bots
|
||||
|
||||
```
|
||||
/bots unload all
|
||||
```
|
||||
|
||||
### `changeslot`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Change your selected slot in the hotbar.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/changeslot <1-9>
|
||||
```
|
||||
|
||||
### `chunk`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Displays the chunk loading status in a nice way.
|
||||
|
||||
> **⚠️ WARNING: To use this feature you need to enable the [Terrain and Movements](configuration.md#terrainandmovements)**
|
||||
|
||||
> **ℹ️ NOTE: You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: [`enableemoji`](configuration.md#enableemoji)**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/chunk status [chunkX chunkZ|locationX locationY locationZ]
|
||||
```
|
||||
|
||||
How it looks:
|
||||
|
||||
|
||||
|
||||
### `dig`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Dig a block on a specific coordinate.
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/dig <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dig 127 63 12
|
||||
```
|
||||
|
||||
Using relative coordinates:
|
||||
|
||||
```
|
||||
/dig ~ ~-1 ~2
|
||||
```
|
||||
|
||||
### `dropitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Drop all items of a specific type from your inventory.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/dropitem <itemtype>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All item types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs).**
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dropitem diamond
|
||||
```
|
||||
|
||||
### `entity`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Attack an entity, use an entity or get a list of entities around you.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Entity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/entity <id|entitytype> <attack|use>
|
||||
```
|
||||
|
||||
Get a list of entities around you:
|
||||
|
||||
```
|
||||
/entity
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All entity types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/EntityType.cs).**
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Attack a Zombie:
|
||||
|
||||
```
|
||||
/entity Zombie attack
|
||||
```
|
||||
|
||||
### `execif`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute a command if a specific condition is met.
|
||||
|
||||
The condition is a C# expression and the local variables you set using [`set`](#set), [`setrnd`](#setrnd) or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.
|
||||
|
||||
Also the instance of MCC is available with `MCC.`.
|
||||
|
||||
> **ℹ️ NOTE: All local variables are treated as strings in the app, when comparing their values, you can use `<variable> == "<value>"`, or better use [`.Equals`](https://www.programiz.com/csharp-programming/library/string/equals) method**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
Basic usage: `/execif <condition (C# expression)> ---> <command>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Setting a variable and using it:
|
||||
|
||||
```
|
||||
/set test=Something
|
||||
/execif test == "Something" ---> send Success!
|
||||
```
|
||||
|
||||
```
|
||||
/set test2=1
|
||||
/execif test2 == "1" ---> send Success 2!
|
||||
```
|
||||
|
||||
|
||||
Basic C# expression:
|
||||
|
||||
```
|
||||
/execif 1 + 2 + 3 == 6 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using MCC class:
|
||||
|
||||
```
|
||||
/execif MCC.GetHealth() == 20.0 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using in combination with [`execmulti`](#execmulti):
|
||||
|
||||
```
|
||||
/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3
|
||||
```
|
||||
|
||||
### `execmulti`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute multiple commands in succession on a single line, useful for debugging or when using [`execif`](#execif)
|
||||
|
||||
Commands are separated by `->`
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
Basic usage: `execmulti <command 1> -> <command 2> -> <command 3> -> ...`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/execmulti send 1 -> send 2 -> send 3 -> sneak
|
||||
```
|
||||
|
||||
### `quit`
|
||||
|
||||
- **Alias:** `exit`
|
||||
- **Description:**
|
||||
|
||||
Disconnect from the server and close the application
|
||||
|
||||
### `reco`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Disconnect and reconnect to the server
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/reco [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `reload`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Reloads settings from MinecraftClient.ini and Chat Bots.
|
||||
|
||||
> **ℹ️ NOTE: Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/reload
|
||||
```
|
||||
|
||||
### `connect`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Go to the given server and resume the script
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/connect <server> [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<server>` is either a server IP or a server alias defined in servers file, for more info check out [serverlist](configuration.html#serverlist)**
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `script`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Run a script containing a list of commands
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/script <script name>
|
||||
```
|
||||
|
||||
### `send`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Send a message or a command to the server
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/send <text>
|
||||
```
|
||||
|
||||
### `respawn`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use this to respawn if you are dead (like clicking "respawn" in-game)
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/respawn
|
||||
```
|
||||
|
||||
### `log`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Display some text in the console (useful for scripts)
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/log <text>
|
||||
```
|
||||
|
||||
- Example:
|
||||
|
||||
```
|
||||
/log this is some text
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- **Description:**
|
||||
|
||||
List players logged in to the server (uses tab list info sent by server)
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/list
|
||||
```
|
||||
|
||||
### `set`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a value which can be used as `%variable%` in further commands
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/set <variable>=<value>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/set abc=123
|
||||
```
|
||||
|
||||
### `setrnd`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a `%variable%` randomly to one of the provided values
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/setrnd <variable> string1 "\"string2\" string3"
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/setrnd <variable> -7to10
|
||||
```
|
||||
|
||||
(Set a `%variable%` to a number from -7 to 9)
|
||||
|
||||
### `sneak`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle sneaking.
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/Sneak
|
||||
```
|
||||
|
||||
### `tps`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Get the server TPS (Ticks Per Second).
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/tps
|
||||
```
|
||||
|
||||
### `useitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use item in the hand, this can be used to do a right click on items which open menus on servers.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/useitem
|
||||
```
|
||||
|
||||
### `useblock`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Place a block from a hand on a specific coordinate or open an inventory:
|
||||
|
||||
- chest/trap chest
|
||||
- furnace
|
||||
- brewing stand
|
||||
- dispenser/dropper
|
||||
- hopper
|
||||
- shulker
|
||||
- loom
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **ℹ️ NOTE: Not all inventories have a GUI representation in an ASCII art format.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/useblock <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/useblock 43 72 7
|
||||
```
|
||||
|
||||
### `follow`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Make the bot follow a player.
|
||||
|
||||
> **ℹ️ NOTE: This command is avaliable only with [Follow Player](chat-bots.md#follow-player) Chat Bot enabled.**
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.** > **ℹ️ NOTE: You need to have [Enity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/follow <player name|stop>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/follow milutinke
|
||||
```
|
||||
|
||||
### `wait`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Wait X ticks (10 ticks = ~1 second. Only for scripts)
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/wait <time>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/wait 20
|
||||
```
|
||||
|
||||
### `move`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for moving when terrain and movements feature is enabled.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Terrain and Movements](configuration.md#terrainandmovements) is currently not supported in `1.4.6 - 1.6`.**
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Enable gravity
|
||||
|
||||
```
|
||||
/move gravity on
|
||||
```
|
||||
|
||||
Move to coordinates:
|
||||
|
||||
```
|
||||
/move 125 72 34
|
||||
```
|
||||
|
||||
Move to a center of a block:
|
||||
|
||||
```
|
||||
/move center
|
||||
```
|
||||
|
||||
### `look`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for looking at direction when terrain and movements is enabled
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
```
|
||||
/look <x y z|yaw pitch|up|down|east|west|north|south>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/look up
|
||||
```
|
||||
|
||||
```
|
||||
/look east
|
||||
```
|
||||
|
||||
### `inventory`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for inventory manipulation.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.
|
||||
|
||||
Inventory has slots and each one of them has an id.
|
||||
|
||||
> **ℹ️ NOTE: This command DOES NOT physically open a container (eg. chest), for that you need to use [`useblock`](#useblock) command first.**
|
||||
|
||||
An example of player inventory with annotated IDs in ASCII art and a list of items:
|
||||
|
||||
|
||||
|
||||
- **Benutzung:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: player and container can be simplified with p and c accordingly**
|
||||
|
||||
Actions:
|
||||
|
||||
- `click`
|
||||
- `shiftclick`
|
||||
- `drop`
|
||||
|
||||
Show/Preview items in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id>
|
||||
```
|
||||
|
||||
Click/Shift-Click on an item in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: The default click is left click**
|
||||
|
||||
Close an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> close
|
||||
```
|
||||
|
||||
Drop item(s) from an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id> drop <slot id> <number of items|all>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To drop all items from a slot, you can use:** `all`
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive <slot id> <item type> <amount>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete <slot id>
|
||||
```
|
||||
|
||||
Show all available inventories:
|
||||
|
||||
```
|
||||
/inventory inventories
|
||||
```
|
||||
|
||||
Search for an item of specified type in available inventories:
|
||||
|
||||
```
|
||||
/inventory search <item type>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Show player's inventory:
|
||||
|
||||
```
|
||||
/inventory player
|
||||
```
|
||||
|
||||
Show/Preview items in an inventory using an id:
|
||||
|
||||
```
|
||||
/inventory 3
|
||||
```
|
||||
|
||||
Click on an item in player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player click 36
|
||||
```
|
||||
|
||||
Right-Click on an item in slot number/id `4` in an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 click 4 right
|
||||
```
|
||||
|
||||
Close an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 close
|
||||
```
|
||||
|
||||
Drop a single item from a player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player drop 36 1
|
||||
```
|
||||
|
||||
Drop all items from a player's inventory in slot number/id `37`:
|
||||
|
||||
```
|
||||
/inventory player drop 37 all
|
||||
```
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive 36 diamondblock 64
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory in slot number/id `36` when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete 36
|
||||
```
|
||||
|
||||
Search for 10 Slime Blocks in available inventories:
|
||||
|
||||
```
|
||||
/inventory s SlimeBlock 10
|
||||
```
|
||||
|
||||
### `debug`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle debug messages, useful for chatbot developers.
|
||||
|
||||
### `help`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Show commands help.
|
||||
|
||||
> **ℹ️ NOTE: Use "/send /help" for server help**
|
||||
28
docs/el/README.md
Normal file
28
docs/el/README.md
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
home: true
|
||||
heroImage: /images/MCC_logo_with_edge.png
|
||||
tagline: 'Minecraft Console Client (MCC) is a lightweight open-source Minecraft Java client implemented in C#'
|
||||
actions:
|
||||
-
|
||||
text: Installation
|
||||
link: ./guide/installation.md
|
||||
type: primary
|
||||
-
|
||||
text: Learn More →
|
||||
link: ./guide/
|
||||
type: secondary
|
||||
actionText:
|
||||
actionLink:
|
||||
features:
|
||||
-
|
||||
title: Chat
|
||||
details: Chat with other people on the server
|
||||
-
|
||||
title: Automation
|
||||
details: Create bots to do automated tasks
|
||||
-
|
||||
title: Supported Versions
|
||||
details: 1.4 - 1.19.2
|
||||
footer: Made by MCC Team with ❤️
|
||||
---
|
||||
|
||||
163
docs/el/guide/README.md
Normal file
163
docs/el/guide/README.md
Normal file
|
|
@ -0,0 +1,163 @@
|
|||
# Introduction
|
||||
|
||||
- [About](#about)
|
||||
- [Quick Intro (YouTube Videos)](#quick-intro)
|
||||
- [Features](#features)
|
||||
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
||||
- [Getting Help](#getting-help)
|
||||
- [Submitting a bug report or an idea/feature-request](#bugs-ideas-feature-requests)
|
||||
- [Important notes on some features](#notes-on-some-features)
|
||||
- [Credits](#credits)
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [License](#license)
|
||||
|
||||
## About
|
||||
|
||||
**Minecraft Console Client (MCC)** is a lightweight cross-platform open-source **Minecraft** TUI client for **Java edition** that allows you to connect to any Minecraft Java 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, as well as extensible C# API for creating Bots.
|
||||
|
||||
It was originally made by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
||||
|
||||
## Features
|
||||
|
||||
- Chat
|
||||
|
||||
- Send and receive chat messages
|
||||
- [Log chat history](chat-bots.md#chat-log)
|
||||
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
|
||||
- [Anti AFK](chat-bots.md#anti-afk)
|
||||
- [Auto Relog](chat-bots.md#auto-relog)
|
||||
- [Script Scheduler](chat-bots.md#script-scheduler)
|
||||
- [Remote Control](chat-bots.md#remote-control)
|
||||
- [Auto Respond](chat-bots.md#auto-respond)
|
||||
- [Auto Attack](chat-bots.md#auto-attack)
|
||||
- [Auto Fishing](chat-bots.md#auto-fishing)
|
||||
- [Auto Eat](chat-bots.md#auto-eat)
|
||||
- [Auto Craft](chat-bots.md#auto-craft)
|
||||
- [Mailer Bot](chat-bots.md#mailer)
|
||||
- [Auto Drop](chat-bots.md#auto-drop)
|
||||
- [Replay Mod](chat-bots.md#replay-mod)
|
||||
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
||||
- [Docker Support](installation.md#using-docker)
|
||||
- [Inventory Handling](usage.md#inventory)
|
||||
- [Terrain Traversing](usage.md#move)
|
||||
- Entity Handling
|
||||
|
||||
_NOTE: Some of mentioned features are disabled by default and you will have to turn them on in the configuration file and some may require additional configuration on your part for your specific usage._
|
||||
|
||||
## Why Minecraft Console Client?
|
||||
|
||||
- Easy to use
|
||||
- Helpful community
|
||||
- Open-Source
|
||||
- Fast performance
|
||||
- Cross-Platform
|
||||
- Docker Support
|
||||
- 10 years of continuous development
|
||||
- Active contributors
|
||||
- Widely used
|
||||
|
||||
## Quick Intro
|
||||
|
||||
Don't have time to read through the documentation, we got you, our community has made some simple introduction videos about the **Minecraft Console Client**.
|
||||
|
||||
### The list of the tutorials:
|
||||
|
||||
Installation:
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
Using Commands, Scripts and other features:
|
||||
|
||||
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
||||
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
||||
|
||||
## Getting Help
|
||||
|
||||
MCC has a community that is willing to help, we have a Discussions section in out Git Hub repository.
|
||||
|
||||
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) to access it.
|
||||
|
||||
### Before getting help
|
||||
|
||||
- **Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!**
|
||||
- **Please be kind and patient, respect others as they're the ones using their time to help you**
|
||||
|
||||
## Bugs, Ideas, Feature Requests
|
||||
|
||||
Bug reporting, idea submitting or feature requesting are done in the [Issues](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [Github repository]([here](https://github.com/MCCTeam/Minecraft-Console-Client)).
|
||||
|
||||
Navigate to the Issues section, search for a bug, idea or a feature using the search option here in the documentation and in the `Issues` section on Git Hub before making your own.
|
||||
|
||||
If you haven't found anything similar, go ahead and click on the `New issue` button, then choose what you want to do.
|
||||
|
||||
If you're reporting a bug, please be descriptive as much as possible, try to explain how to re-create the bug, attack screenshots and logs, make sure that you have [`debugmessages`](configuration.me#debugmessages) set to `true` before sending a bug report or taking a screenshot.
|
||||
|
||||
### Before submitting
|
||||
|
||||
- **Please use the search option here or in the `Issues` section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!**
|
||||
- **Please be kind, patient and respect others. Thank you!**
|
||||
|
||||
## Notes on some features
|
||||
|
||||
### Inventory, Terrain and Entity Handling
|
||||
|
||||
Inventory handling is currently not supported in versions: `1.4.6 - 1.9`
|
||||
|
||||
Terrain handling is currently not supported in versions: `1.4.6 - 1.6`
|
||||
|
||||
Entity handling is currently not supported in versions: `1.4.6 - 1.9` (but `1.8` and `1.9` are being worked on, almost at the working state, only `EntityMetadata` packet remains to be fixed)
|
||||
|
||||
There features might not always be implemented in the latest version of the game, since they're often subjected to major changes by Mojang, and we need some time to figure out what has changed and to implement the required changes.
|
||||
|
||||
If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.
|
||||
|
||||
## Credits
|
||||
|
||||
_Project initiated by [ORelio](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
||||
|
||||
Many features would not have been possible without the help of our talented community:
|
||||
|
||||
**Maintainers**
|
||||
|
||||
ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte
|
||||
|
||||
**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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
||||
|
||||
**Bug Hunters**
|
||||
|
||||
1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, 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 and [many more](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
||||
|
||||
**Contributors**
|
||||
|
||||
Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte _... And all the [GitHub contributors](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
||||
|
||||
**Libraries:**
|
||||
|
||||
Minecraft Console Client also borrows code from the following libraries:
|
||||
|
||||
| Name | Purpose | Author | License |
|
||||
| ----------- | ---------------- | ---------------- | ------- |
|
||||
| Biko | Proxy handling | Benton Stark | MIT |
|
||||
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
||||
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
||||
|
||||
## Disclaimer
|
||||
|
||||
Even if everything should work, we are not responsible for 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 from the source code.
|
||||
|
||||
Also, remember that when you connect to a server with this program, you will appear where you left the last time. This means that **you can die if you log in in an unsafe place on a survival server!** Use the script scheduler bot to send a teleport command after logging in.
|
||||
|
||||
We remind you that **you may get banned** by your server for using this program. Use accordingly with server rules.
|
||||
|
||||
## License
|
||||
|
||||
Minecraft Console Client is a totally free of charge, open source project. The source code is available at [Github Repository](https://github.com/MCCTeam/Minecraft-Console-Client)
|
||||
|
||||
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html) Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|
||||
1921
docs/el/guide/chat-bots.md
Normal file
1921
docs/el/guide/chat-bots.md
Normal file
File diff suppressed because it is too large
Load diff
1185
docs/el/guide/configuration.md
Normal file
1185
docs/el/guide/configuration.md
Normal file
File diff suppressed because it is too large
Load diff
76
docs/el/guide/contibuting.md
Normal file
76
docs/el/guide/contibuting.md
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
# Contributing
|
||||
|
||||
At this moment this page needs to be created.
|
||||
|
||||
For now you can use our article from the [Git Hub repository Wiki](https://github.com/MCCTeam/Minecraft-Console-Client/wiki/Update-console-client-to-new-version) written by [ReinforceZwei](https://github.com/ReinforceZwei).
|
||||
|
||||
## Translations
|
||||
|
||||
MCC now supports the following languages (Alphabetical order) :
|
||||
* `de.ini` : Deutsch - German
|
||||
* **`en.ini` : English - English**
|
||||
* `fr.ini` : Français (France) - French
|
||||
* `ru.ini` : Русский (Russkiy) - Russian
|
||||
* `vi.ini` : Tiếng Việt (Việt Nam) - Vietnamese
|
||||
* `zh-Hans.ini` : 简体中文 - Chinese Simplified
|
||||
* `zh-Hant.ini` : 繁體中文 - Chinese Traditional
|
||||
|
||||
### Add new translation
|
||||
|
||||
1. First you need to get the name of the translated file.
|
||||
* Visit [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) and find the first occurrence of the language you need to translate in the table below.
|
||||
* Use the language code of the row in the table as the name of the translation file.
|
||||
* For example:
|
||||
* `English` -> row `English 0x0009` -> `en` -> `en.ini`
|
||||
* `Chinese (Traditional)` -> row `Chinese (Traditional) 0x7C04` -> `zh-Hant` -> `zh-Hant.ini`
|
||||
|
||||
2. Which system languages are recommended to use this translation?
|
||||
* Still check the table in [this link](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c), one language may have multiple rows.
|
||||
* You will need to indicate which language codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `de.ini` applies to `de`, `de-AT`, `de-BE`, `de-DE`, ...
|
||||
* Translation `zh-Hans.ini` applies to `zh-Hans`, `zh`, `zh-CN`, `zh-SG`.
|
||||
|
||||
3. Which game languages are recommended to use this translation?
|
||||
* Check out the table in [this link](https://github.com/MCCTeam/Minecraft-Console-Client/discussions/2239), where the `Locale Code` column indicates the language code in minecraft.
|
||||
* You will need to indicate which locale codes this translation applies to.
|
||||
* For example:
|
||||
* Translation `fr.ini` applies to `fr_ca`, `fr_fr`.
|
||||
* Translation `zh-Hans.ini` applies to `zh_cn`.
|
||||
|
||||
4. Add the new translation to the code. (Optional)
|
||||
* **If you are not familiar with programming, you can skip this step and just write the above information in your PR or issue.**
|
||||
* Add the newly created translation file `xx.ini` to the project `/Resources/lang/xx.ini`.
|
||||
* Open `/DefaultConfigResource.resx`.
|
||||
* Click `Add Resources`.
|
||||
* Choose `/Resources/lang/xx.ini`.
|
||||
* Rename the added resource file in `/DefaultConfigResource.resx` to `Translation_xx`.
|
||||
* Open `/Translations.cs`.
|
||||
* Find `public static Tuple<string, string[]> GetTranslationPriority();`
|
||||
* Update the mapping of system language codes to translation files.
|
||||
* Find `public static string[] GetTranslationPriority(string gameLanguage);`
|
||||
* Update the mapping of game locale code to translation files.
|
||||
|
||||
5. Follow the section "Update existing translation".
|
||||
|
||||
### Update existing translation
|
||||
|
||||
1. Visit [the lang folder](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/Resources/lang), download `en.ini` and the language you want to translate(`xx.ini`).
|
||||
|
||||
2. Compare `en.ini` and `xx.ini` and update outdated or non-existent entries in `xx.ini`.
|
||||
|
||||
3. 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.
|
||||
|
||||
### Translate README.md
|
||||
|
||||
1. Get the English version of the README.md from [here](https://raw.githubusercontent.com/MCCTeam/Minecraft-Console-Client/master/README.md).
|
||||
|
||||
2. See `Add new translation -> 1.` for the target language code. Assume it is `xx`.
|
||||
|
||||
3. Complete the translation according to the English README.md and name the translated version as `README-xx.md`.
|
||||
|
||||
4. In the English README, above the "About" section, add the name of the language and a hyperlink to `README-xx.md`.
|
||||
|
||||
## Contributors
|
||||
|
||||
[Check out our contributors on Github](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors).
|
||||
170
docs/el/guide/creating-bots.md
Normal file
170
docs/el/guide/creating-bots.md
Normal file
|
|
@ -0,0 +1,170 @@
|
|||
# Creating Chat Bots
|
||||
|
||||
- [Notes](#notes)
|
||||
- [Requirements](#requirements)
|
||||
- [Quick Introduction](#quick-introduction)
|
||||
- [Examples](#examples)
|
||||
- [C# API](#c#-api)
|
||||
|
||||
## Notes
|
||||
|
||||
> **ℹ️ NOTE: For now this page contains only the bare basics of the Chat Bot API, enough of details to teach you how to make basic Chat Bots. For more details you need to take a look at the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) and [Examples](#examples). This page will be improved in the future.**
|
||||
|
||||
**Minecraft Console Client** has a rich C# API which allows you to create Chat Bots (effectively plugins) which can help you create complex automations which normal scripts may not be able to do.
|
||||
|
||||
## Requirements
|
||||
|
||||
- A basic knowledge of C# programming language
|
||||
- A text editor
|
||||
|
||||
If you're not familiar with the C# programming language, we suggest taking a look at the following resources:
|
||||
|
||||
Crash courses:
|
||||
|
||||
- [C# Crash Course playlist by Teddy Smit](https://www.youtube.com/watch?v=67oWw9TanOk&list=PL82C6-O4XrHfoN_Y4MwGvJz5BntiL0z0D)
|
||||
|
||||
More in-depth:
|
||||
|
||||
- [Learn C# Youtube Playlist by Microsoft](https://www.youtube.com/playlist?list=PLdo4fOcmZ0oVxKLQCHpiUWun7vlJJvUiN)
|
||||
- [Getting started with C# (An index of tutorials and the documentation) by Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/)
|
||||
|
||||
## Quick Introduction
|
||||
|
||||
This introduction assumes that you have the basic knowledge of C#.
|
||||
|
||||
> **ℹ️ NOTE: Here we will use terms Chat Bot and Script interchangeably**
|
||||
|
||||
Create a new empty file and name it `ExampleChatBot.cs` in the same folder where you have your MCC installed.
|
||||
|
||||
Paste the following example code:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
|
||||
// The code and comments above are defining a "Script Metadata" section
|
||||
|
||||
// Every single chat bot (script) must be a class which extends the ChatBot class.
|
||||
// Your class must be instantiates in the "Script Metadata" section and passed to MCC.LoadBot function.
|
||||
class ExampleChatBot : ChatBot
|
||||
{
|
||||
// This method will be called when the script has been initialized for the first time, it's called only once
|
||||
// Here you can initialize variables, eg. Dictionaries. etc...
|
||||
public override void Initialize()
|
||||
{
|
||||
LogToConsole("An example Chat Bot has been initialized!");
|
||||
}
|
||||
|
||||
// This is a function that will be run when we get a chat message from a server
|
||||
// In this example it just detects the type of the message and prints it out
|
||||
public override void GetText(string text)
|
||||
{
|
||||
string message = "";
|
||||
string username = "";
|
||||
text = GetVerbatim(text);
|
||||
|
||||
if (IsPrivateMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has sent you a private message: " + message);
|
||||
}
|
||||
else if (IsChatMessage(text, ref message, ref username))
|
||||
{
|
||||
LogToConsole(username + " has said: " + message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Start MCC, connect to a server and run the following internal command: `/script ExampleChatBot.cs`.
|
||||
|
||||
If you did everything right you should see: `[Example Chat Bot] An example Chat Bot has been initialised!` message appear in your console log.
|
||||
|
||||
### Structure of Chat Bots
|
||||
|
||||
Chat Bot (Script) structure is the following:
|
||||
|
||||
```
|
||||
<script metadata>
|
||||
<chat bot class>
|
||||
```
|
||||
|
||||
**Script Metadata** is a section with a custom format that mixes in C# with our format using comments. Every single Chat Bot (Script) must have this section at the beginning in order to work.
|
||||
|
||||
### Script Metadata Format
|
||||
|
||||
`//MCCScript 1.0` marks the beginning of the **Script Metadata** section, this must always be on the first line or the Chat Bot (Script) will not load and will throw an error.
|
||||
|
||||
`//MCCScript Extensions` marks the end of the **Script Metadata** section, this must be defined before a Chat Bot (Script) class.
|
||||
|
||||
In order for your Chat Bot (Script) to properly load in-between the `//MCCScript 1.0` and the `//MCCScript Extensions` lines you must instantiate your Chat Bot (Script) class and pass it to the `MCC.LoadBot` function.
|
||||
|
||||
Example code:
|
||||
|
||||
```
|
||||
MCC.LoadBot(new YourChatBotClassNameHere());
|
||||
```
|
||||
|
||||
**Script Metadata** section allows for including C# packages and libraries with: `//using <namespace>` and `/dll <dll name>`.
|
||||
|
||||
> **ℹ️ NOTE: Avoid adding whitespace between `//` and keywords**
|
||||
|
||||
By the default the following packages are loaded:
|
||||
|
||||
```csharp
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Text.RegularExpressions;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using System.IO;
|
||||
using System.Net;
|
||||
using System.Threading;
|
||||
using MinecraftClient;
|
||||
using MinecraftClient.Mapping;
|
||||
using MinecraftClient.Inventory;
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```csharp
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
```
|
||||
|
||||
Full Example:
|
||||
|
||||
```csharp
|
||||
//MCCScript 1.0
|
||||
|
||||
//using System.Collections.Immutable
|
||||
//dll MyDll.dll
|
||||
|
||||
MCC.LoadBot(new ExampleChatBot());
|
||||
|
||||
//MCCScript Extensions
|
||||
```
|
||||
|
||||
### Chat Bot Class
|
||||
|
||||
After the end of the **Script Metadata** section, you basically can define any number of classes you like, the only limitation is that the main class of your Chat Bot (Script) must extend `ChatBot` class.
|
||||
|
||||
There are no required methods, everything is optional.
|
||||
|
||||
When the Chat Bot (Script) has been initialized for the first time the `Initialize` method will be called. In it you can initialize variables, eg. Dictionaries, etc..
|
||||
|
||||
> **ℹ️ NOTE: For allocating resources like a database connection, we recommend allocating them in `AfterGameJoined` and freeing them in `OnDisconnect`**.
|
||||
|
||||
## Examples
|
||||
|
||||
You can find a lot of examples in our Git Hub Repository at [ChatBots](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/ChatBots) and [config](https://github.com/MCCTeam/Minecraft-Console-Client/tree/master/MinecraftClient/config).
|
||||
|
||||
## C# API
|
||||
|
||||
As of the time of writing, the C# API has been changed in forks that are yet to be merged, so for now you can use the [ChatBot.cs](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Scripting/ChatBot.cs) for reference.
|
||||
|
||||
Each method is well documented with standard C# documentation comments.
|
||||
|
||||
In the future we will make a script to auto-generate this section based on the documentation in the code.
|
||||
931
docs/el/guide/installation.md
Normal file
931
docs/el/guide/installation.md
Normal file
|
|
@ -0,0 +1,931 @@
|
|||
# Installation
|
||||
|
||||
- [YouTube Tutorials](#youtube-tutorials)
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker)
|
||||
- [Run on Android](#run-on-android)
|
||||
- [Run MCC 24/7 on a VPS](#run-on-a-vps)
|
||||
|
||||
## YouTube Tutorials
|
||||
|
||||
If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.
|
||||
|
||||
- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
||||
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
||||
|
||||
## Download a compiled binary
|
||||
|
||||
In order to run **Minecraft Console Client** you need [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download)
|
||||
|
||||
> **⚠️ IMPORTANT: If you already have .NET, but an older version than `6.0`, please update to `6.0` since MCC might not work as expected or at all.**
|
||||
|
||||
#### How to install .NET on your platform
|
||||
|
||||
- [Install .NET on Windows](https://docs.microsoft.com/en-us/dotnet/core/install/windows)
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Download
|
||||
|
||||
You can download a compiled binary file of the latest build from our Releases section on Git Hub: [Download](https://github.com/MCCTeam/Minecraft-Console-Client/releases)
|
||||
|
||||
## Building from the source code
|
||||
|
||||
### Windows
|
||||
|
||||
Requirements:
|
||||
|
||||
- [Git](https://www.git-scm.com/)
|
||||
- [.NET 6.0 or new-er](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
Install [Git](https://www.git-scm.com/)
|
||||
|
||||
1. Make a new folder where you want to keep the source code
|
||||
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
|
||||
3. Click on `Git Bash Here` in the context menu
|
||||
4. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
|
||||
6. Open up the new cloned folder
|
||||
|
||||
#### Building using the Visual Studio
|
||||
|
||||
1. Open up the `MinecraftClient.sln` via Visual Studio
|
||||
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
3. Click on `Properties`
|
||||
4. Open up the `Build` tab and select configuration `Release`
|
||||
5. Press `CTRL + S` and close the file
|
||||
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
|
||||
7. Click `Build`
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
#### Building using .NET manually without Visual Studio
|
||||
|
||||
1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
|
||||
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
|
||||
3. Run the following command to build the project:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r win-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net6.0/win-x64/publish` folder.
|
||||
|
||||
### Linux, macOS
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
|
||||
- Linux:
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**
|
||||
|
||||
- [Install Git on macOS](https://git-scm.com/download/mac)
|
||||
|
||||
- .NET SDK 6.0 or new-er
|
||||
|
||||
- [Install .NET on Linux](https://docs.microsoft.com/en-us/dotnet/core/install/linux)
|
||||
- [Install .NET on macOS](https://docs.microsoft.com/en-us/dotnet/core/install/macos)
|
||||
|
||||
#### Cloning using Git
|
||||
|
||||
1. Open up a terminal emulator and navigate to the folder where you will store the MCC
|
||||
2. Recursively clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)
|
||||
4. Run the following command to build the project:
|
||||
|
||||
- On Linux:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r linux-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're using Linux that is either ARM, 32-bit, Rhel based, Using Musl, or Tirzen, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace the `'-r linux-64` with an appropriate `-r <your RID>` (Example for arm: `-r linux-arm64`)**
|
||||
|
||||
- On macOS:
|
||||
|
||||
```bash
|
||||
dotnet publish MinecraftClient -f net6.0 -r osx-x64 --no-self-contained -c Release -p:UseAppHost=true -p:IncludeNativeLibrariesForSelfExtract=true -p:DebugType=None
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're not using MAC with Intel, find an appropriate RID for your ARM processor, [find an appropriate RID](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) and replace the `'-r osx-64` with an appropriate `-r <your RID>` (Example for arm: `-r osx.12-arm64`)**
|
||||
|
||||
If the build has succeeded, the compiled binary `MinecraftClient` will be in:
|
||||
|
||||
- Linux: `MinecraftClient/bin/Release/net6.0/linux-x64/publish/`
|
||||
- macOS: `MinecraftClient/bin/Release/net6.0/osx-x64/publish/`
|
||||
|
||||
## Using Docker
|
||||
|
||||
Requirements:
|
||||
|
||||
- Git
|
||||
- Docker
|
||||
|
||||
> **ℹ️ NOTE: This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**
|
||||
|
||||
> **⚠️ WARNING: Pay attention at warnings, Docker currently works, but you must start the containers in the interactive mode or MCC will crash, we're working on solving this.**
|
||||
|
||||
1. Clone the [Git Hub Repository](https://github.com/MCCTeam/Minecraft-Console-Client) by typing end executing the following command:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
|
||||
```
|
||||
|
||||
2. Navigate to `Minecraft-Console-Client/Docker`
|
||||
3. Build the image using the following command
|
||||
|
||||
```bash
|
||||
docker build -t minecraft-console-client:latest .
|
||||
```
|
||||
|
||||
**Start the container using Docker:**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: There is a bug with the ConsoleInteractive which causes a crash when a container is started in a headless mode, so you need to use the interactive mode. Do not restart containers in a classic way, stop then and start them with interactive mode (this command), after that simply detach with `CTRL + P` and then `CTRL + Q`.**
|
||||
|
||||
```bash
|
||||
# You could also ignore the -v parameter if you dont want to mount the volume that is up to you. If you don't it's harder to edit the .ini file if thats something you want to do
|
||||
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
|
||||
```
|
||||
|
||||
Now you could login and the Client is running. To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`. To reattach use the `docker attach` command.
|
||||
|
||||
**Start the container using docker-compose:**
|
||||
|
||||
By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.
|
||||
|
||||
If you don't want to map a volume, you have to comment out or delete the entire volumes section:
|
||||
|
||||
```yml
|
||||
#volumes:
|
||||
#- './data:/opt/data'
|
||||
```
|
||||
|
||||
Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:
|
||||
|
||||
```bash
|
||||
docker-compose run MCC
|
||||
```
|
||||
|
||||
Remember to remove the container after usage:
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
If you use the INI file and entered your data (username, password, server) there, you can start your container using
|
||||
|
||||
```bash
|
||||
docker-compose up
|
||||
docker-compose up -d #for deamonized running in the background
|
||||
```
|
||||
|
||||
Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`. As above, you can stop and remove the container using
|
||||
|
||||
```bash
|
||||
docker-compose down
|
||||
```
|
||||
|
||||
## Run on Android
|
||||
|
||||
It is possible to run the Minecraft Console Client on Android through Termux and Ubuntu 22.04 in it, however it requires a manual setup with a lot of commands, be careful no to skip any steps. Note that this might take anywhere from 10 to 20 minutes or more to do depending on your technical knowledge level, Internet speed and CPU speed.
|
||||
|
||||
> **ℹ️ NOTE: This section is going to get a bit technical, I'll try my best to make everything as simple as possible. If you are having trouble following along or if you encounter any issues, feel free to open up a discussion on our Github repository page.**
|
||||
|
||||
> **ℹ️ NOTE: You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**
|
||||
|
||||
> **ℹ️ NOTE: Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**
|
||||
|
||||
### Installation
|
||||
|
||||
#### Termux
|
||||
|
||||
> **⚠️ IMPORTANT: The Play Store version of Termux is outdated and not supported, do not use it, use the the [Github one](https://github.com/termux/termux-app/releases/latest/).**
|
||||
|
||||
Go to [the Termux Github latest release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it and run it.
|
||||
|
||||
> **ℹ️ NOTE: If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.**
|
||||
|
||||
> **⚠️ VERY IMPORTANT ⚠️: Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!**
|
||||
|
||||
#### Installing Ubuntu 22.04
|
||||
|
||||
At this stage, you have 2 options:
|
||||
|
||||
1. Following this textual tutorial
|
||||
2. Watching a [Youtube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM)
|
||||
|
||||
> **ℹ️ NOTE: If you decide to watch the Youtube tutorial, watch only up to `1:58`, the steps after are not needed and might just confuse you.**
|
||||
|
||||
In order to install Ubuntu 22.04 in Termux you require `wget` and `proot`, we're going to install them in the next step.
|
||||
|
||||
Once you have Termux installed open it up and run the following command one after other (in order):
|
||||
|
||||
1. `pkg update`
|
||||
2. `pkg upgrade`
|
||||
3. `pkg install proot wget`
|
||||
|
||||
> **ℹ️ NOTE: If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter**
|
||||
|
||||
Then you need to download an installation script using the following command:
|
||||
|
||||
```bash
|
||||
wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh
|
||||
```
|
||||
|
||||
Once the script has downloaded, run it with:
|
||||
|
||||
```bash
|
||||
bash ubuntu.sh
|
||||
```
|
||||
|
||||
Then you will be asked a question, enter `Y` and press `Enter`. Once the installation is complete, you can start Ubuntu with:
|
||||
|
||||
```bash
|
||||
./startubuntu.sh
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command**
|
||||
|
||||
#### Installing .NET on ARM
|
||||
|
||||
Since there are issues installing .NET 6.0 via the APT package manager at the time of writing, we will have to install it manually.
|
||||
|
||||
First we need to update the APT package manager repositories and install dependencies.
|
||||
|
||||
To update the APT repositories, run the following command:
|
||||
|
||||
```bash
|
||||
apt update -y && apt upgrade -y
|
||||
```
|
||||
|
||||
After you did it, we need to install dependencies for .NET, with the following command:
|
||||
|
||||
```bash
|
||||
apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y
|
||||
```
|
||||
|
||||
After you have installed dependencies, it's time to install .NET, you either can follow this tutorial or the [Microsoft one](https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install).
|
||||
|
||||
Navigate to your `/root` home directory with the following command:
|
||||
|
||||
```bash
|
||||
cd /root
|
||||
```
|
||||
|
||||
First you need to download .NET 6.0, you can do it with the following command:
|
||||
|
||||
```bash
|
||||
wget https://download.visualstudio.microsoft.com/download/pr/901f7928-5479-4d32-a9e5-ba66162ca0e4/d00b935ec4dc79a27f5bde00712ed3d7/dotnet-sdk-6.0.400-linux-arm64.tar.gz
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you have 64 bit version of ARM processor, if you happen to have a 32-bit version replace the link in the command above with [this one](https://download.visualstudio.microsoft.com/download/pr/cf567026-a29a-41aa-bc3a-e4e1ad0df480/0925d411e8e09e31ba7a39a3eb0e29af/aspnetcore-runtime-6.0.8-linux-arm.tar.gz)**.
|
||||
|
||||
> **ℹ️ NOTE: This tutorial assumes that you're following along and using Ubuntu 22.04, if you're using a different distro, like Alpine, go to [here](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) and copy an appropriate link for your distro.**
|
||||
|
||||
Once the file has been downloaded, you need to run the following commands in order:
|
||||
|
||||
1. `DOTNET_FILE=dotnet-sdk-6.0.400-linux-arm64.tar.gz`
|
||||
|
||||
> **⚠️ IMPORTANT: If you're using a different download link, update the file name in this command to match your version.**
|
||||
|
||||
2. `export DOTNET_ROOT=/root/.dotnet`
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"`
|
||||
4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools`
|
||||
|
||||
Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located.
|
||||
|
||||
> **⚠️ IMPORTANT: You will need a basic knowledge of Nano text editor, if you do not know how to use it, watch this [Youtube video tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A)**
|
||||
|
||||
To enable this, we need to edit our `/root/.bashrc` file with the following command:
|
||||
|
||||
```bash
|
||||
nano /root/.bashrc
|
||||
```
|
||||
|
||||
Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text:
|
||||
|
||||
```bash
|
||||
export DOTNET_ROOT=/root/.dotnet/
|
||||
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
|
||||
```
|
||||
|
||||
> **⚠️ IMPORTANT: Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!**
|
||||
|
||||
Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter.
|
||||
|
||||
Veryfy that .NET was installed correctly by running:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get a help page:
|
||||
|
||||
```bash
|
||||
root@localhost:~# dotnet
|
||||
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
#### Installing MCC
|
||||
|
||||
Finally, we can install MCC.
|
||||
|
||||
> **⚠️ IMPORTANT: If you have a 32 ARM processor, you need to build the MCC yourself, take a look at the [Building From Source](#building-from-the-source-code) section. Also make sure to be using the appropriate `-r` parameter value for your architecture.**
|
||||
|
||||
Let's make a folder where the MCC will be stored with the following command:
|
||||
|
||||
```bash
|
||||
mkdir MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Then enter it the newly created folder:
|
||||
|
||||
```bash
|
||||
cd MinecraftConsoleClient
|
||||
```
|
||||
|
||||
Download the MCC with the following command:
|
||||
|
||||
```bash
|
||||
wget https://github.com/MCCTeam/Minecraft-Console-Client/releases/latest/download/MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
Unzip it with the following command:
|
||||
|
||||
```bash
|
||||
unzip MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
You can remove the zip archive now, we do not need it anymore, with:
|
||||
|
||||
```bash
|
||||
rm MinecraftClient-linux-arm64.zip
|
||||
```
|
||||
|
||||
And finally run it with:
|
||||
|
||||
```
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
#### After installation
|
||||
|
||||
When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh`
|
||||
|
||||
Then you can start the MCC again with `./MinecraftClient`
|
||||
|
||||
To stop MCC from running you can press `CTRL + C`
|
||||
|
||||
To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use, if you have followed the installation steps above, you should be familiar with it, if not, check out [this tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).
|
||||
|
||||
For downloading files, you can use the `wget` file we have installed, simply run: `wget your_link_here` (you have examples above, and a video tutorial down bellow).
|
||||
|
||||
Also, here are some linux tutorials for people who are new to it:
|
||||
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
## Run on a VPS
|
||||
|
||||
> **ℹ️ NOTE: This is a new section, if you find a mistake, please report it by opening an Issue in our [Github repository](https://github.com/MCCTeam/Minecraft-Console-Client). Thank you!**
|
||||
|
||||
The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.
|
||||
|
||||
- [What is a VPS?](#what-is-a-vps)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [Where to get a VPS](#where-to-get-a-vps)
|
||||
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
|
||||
- [Initial VPS setup](#initial-vps-setup)
|
||||
- [Creating a new user account](#creating-a-new-user)
|
||||
- [Installing .NET Core 6](#installing-net-core-6)
|
||||
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)
|
||||
|
||||
### What is a VPS?
|
||||
|
||||
VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).
|
||||
|
||||
You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.
|
||||
|
||||
Here is a [Youtube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you're interested.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
1. Gitbash (if you're on Windows)
|
||||
|
||||
Download and install [Gitbash](https://git-scm.com/downloads).
|
||||
|
||||
> **ℹ️ NOTE: Make sure to allow the installation to add it to the context menu**
|
||||
|
||||
2. `ssh` and `ssh-keygen` commands (On Windows they're available with Gitbash, on macOs and Linux they should be available by default, it not, search on how to install them)
|
||||
|
||||
3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.
|
||||
|
||||
If you already know this, feel free to skip.
|
||||
|
||||
if you get stuck, watch those tutorials.
|
||||
|
||||
If you're new to this, you can learn about it here:
|
||||
|
||||
- [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
|
||||
- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
|
||||
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
|
||||
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
|
||||
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)
|
||||
|
||||
### Where to get a VPS
|
||||
|
||||
You have 2 options:
|
||||
|
||||
- [Buying a VPS](#buying-a-vps)
|
||||
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)
|
||||
|
||||
#### Buying a VPS
|
||||
|
||||
If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.
|
||||
|
||||
**What hardware requirements I need for running the MCC?**
|
||||
|
||||
The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.
|
||||
|
||||
**Where to buy a VPS?**
|
||||
|
||||
> **⚠️ VERY IMPORTANT: In this tutorial we will be using `Ubuntu 22.04`, make sure to select it as the OS when buying a VPS.**
|
||||
|
||||
Some of the reliable and cheap hosting providers (sorted for price/performance):
|
||||
|
||||
- [E-Trail](https://e-trail.net/vps)
|
||||
|
||||
**Minimum price**: `2.50 EUR / month`
|
||||
|
||||
> **ℹ️ NOTE: Does not have Ubuntu 22.04 in the dropdown menu when ordering, you will have to re-install later or ask support to do it.**
|
||||
|
||||
- [OVH Cloud](https://www.ovhcloud.com/de/vps/)
|
||||
|
||||
**Minimum price**: `3.57 EUR / month`
|
||||
|
||||
- [Hetzner Cloud](https://www.hetzner.com/cloud)
|
||||
|
||||
**Minimum price**: `4.51 EUR / month`
|
||||
|
||||
- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)
|
||||
|
||||
**Minimum price**: `4 EUR / month`
|
||||
|
||||
- [Contabo](https://contabo.com/en/vps/)
|
||||
|
||||
**Minimum price**: `7 EUR / month`
|
||||
|
||||
**More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**
|
||||
|
||||
You also may want to search for better deals.
|
||||
|
||||
#### AWS EC2 VPS
|
||||
|
||||
> **⚠️ VERY IMPORTANT: This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**
|
||||
|
||||
> **⚠️ WARNING: Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**
|
||||
|
||||
> **⚠️ WARNING: Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**
|
||||
|
||||
> **ℹ️ NOTE: If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**
|
||||
|
||||
Register on AWS and enter all of your billing info and a phone number. Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).
|
||||
|
||||
### Initial Amazon VPS setup
|
||||
|
||||
> **ℹ️ NOTE: Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**
|
||||
|
||||
When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`
|
||||
|
||||
> **ℹ️ NOTE: Make sure to select the region closest to you for the minimal latency**
|
||||
|
||||
Click on the **Launch instance** button.
|
||||
|
||||
Fill out the `Name` field with a name of your preference.
|
||||
|
||||
|
||||
|
||||
For the **Application and OS images** select `Ubuntu Server 22.04 LTS (HVM), SSD Volume Type`.
|
||||
|
||||
> **⚠️ VERY IMPORTANT: Make sure that it has `Free tier eligible` next to it.**
|
||||
|
||||
|
||||
|
||||
For the **Instance type** select `t2.micro`.
|
||||
|
||||
For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.
|
||||
|
||||
> **⚠️ EXTREMELY IMPORTANT: Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**
|
||||
|
||||
|
||||
|
||||
For the **Network settings** check the following checkboxes on:
|
||||
|
||||
- `Allow SSH traffic from` (Anywhere)
|
||||
- `Allow HTTPs traffic from the internet`
|
||||
- `Allow HTTP traffic from the internet`
|
||||
|
||||
> **ℹ️ NOTE: The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**
|
||||
|
||||
|
||||
|
||||
For the **Storage** enter `30`.
|
||||
|
||||
|
||||
|
||||
Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.
|
||||
|
||||
Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.
|
||||
|
||||
You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
In order to login with SSH, you are going to use the following command:
|
||||
|
||||
```bash
|
||||
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<` and `>` are not typed, that is just a notation for a placeholder!**
|
||||
|
||||
> **ℹ️ NOTE: `ubuntu` is a default root account username for Ubuntu on AWS!**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
|
||||
```
|
||||
|
||||
If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.
|
||||
|
||||
Now you can continue to [Creating a new user](#creating-a-new-user)
|
||||
|
||||
### Initial VPS setup
|
||||
|
||||
> **ℹ️ NOTE: This section if for those who do not use AWS, if you use AWS skip it**
|
||||
|
||||
When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.
|
||||
|
||||
Other option is that you will get your login info in the email once the setup is done.
|
||||
|
||||
Once you have the root login account info, you need [Gitbash](https://git-scm.com/downloads) on Windows and `ssh` if you're on macOS or Linux (if you do not have it by some chance, search on how to install it, it is simple).
|
||||
|
||||
If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:
|
||||
|
||||
```bash
|
||||
ssh <username>@<ip>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh root@142.26.73.14
|
||||
```
|
||||
|
||||
Example with port:
|
||||
|
||||
```bash
|
||||
ssh -p 2233 root@142.26.73.14
|
||||
```
|
||||
|
||||
Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.
|
||||
|
||||
### Creating a new user
|
||||
|
||||
Once you've logged in to your VPS you need to create a new user and give it SSH access.
|
||||
|
||||
In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.
|
||||
|
||||
> **ℹ️ NOTE: You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**
|
||||
|
||||
To create a new user named `mcc` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo useradd mcc -m
|
||||
```
|
||||
|
||||
Now we need to give it a password, execute the following command, type the password and confirm it:
|
||||
|
||||
```bash
|
||||
sudo passwd mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: When you're typing a password it will not be displayed on the screen, but you're typing it for real.**
|
||||
|
||||
> **ℹ️ NOTE: Make sure you have a strong password!**
|
||||
|
||||
Now we need to give our user account the admin permissions:
|
||||
|
||||
```bash
|
||||
sudo usermod -aG sudo mcc
|
||||
```
|
||||
|
||||
Now we are going to set it's shell to bash:
|
||||
|
||||
```bash
|
||||
sudo chsh mcc -s /bin/bash
|
||||
```
|
||||
|
||||
Now we need to log in as the `mcc` user:
|
||||
|
||||
```bash
|
||||
su mcc
|
||||
```
|
||||
|
||||
Fill in your password when asked.
|
||||
|
||||
Navigate to the `mcc` user home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Make a new `.ssh` directory:
|
||||
|
||||
```bash
|
||||
mkdir .ssh
|
||||
```
|
||||
|
||||
Enter it with:
|
||||
|
||||
```bash
|
||||
cd .ssh
|
||||
```
|
||||
|
||||
Make a new empty file named `authorized_keys`:
|
||||
|
||||
```bash
|
||||
touch authorized_keys
|
||||
```
|
||||
|
||||
Do no close the Git bash/Terminal emulator. On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account. Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).
|
||||
|
||||
Type the following command:
|
||||
|
||||
```bash
|
||||
ssh-keygen -t RSA -b 4096
|
||||
```
|
||||
|
||||
Enter the name of the key file to be: `MCC_Key`, press Enter.
|
||||
|
||||
When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.
|
||||
|
||||
This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.
|
||||
|
||||
Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.
|
||||
|
||||
Return to the Git Bash/Terminal emulator and execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install nano -y
|
||||
```
|
||||
|
||||
This will install the Nano editor on your VPS.
|
||||
|
||||
Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.
|
||||
|
||||
Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:
|
||||
|
||||
```bash
|
||||
pwd
|
||||
```
|
||||
|
||||
If it does not print `/home/mcc/.ssh`, navigate to it with:
|
||||
|
||||
```bash
|
||||
cd /home/mcc/.ssh
|
||||
```
|
||||
|
||||
Now you need to open the `authorized_keys` file with the nano editor:
|
||||
|
||||
```bash
|
||||
nano authorized_keys
|
||||
```
|
||||
|
||||
Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.
|
||||
|
||||
Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.
|
||||
|
||||
Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:
|
||||
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
```
|
||||
|
||||
Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.
|
||||
|
||||
Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.
|
||||
|
||||
Additionally for better security you can do the following:
|
||||
|
||||
- Set `PermitRootLogin` to `yes`
|
||||
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
|
||||
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)
|
||||
|
||||
Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.
|
||||
|
||||
Now we need to restart the SSHD service with:
|
||||
|
||||
```bash
|
||||
sudo systemctl restart sshd
|
||||
```
|
||||
|
||||
Let's check if everything is working correctly:
|
||||
|
||||
```bash
|
||||
sudo systemctl status sshd
|
||||
```
|
||||
|
||||
If everything has been configured as it should be you should see `active (running)` as a status of the service. If not, open the config file again and check for mistakes.
|
||||
|
||||
Press `q` to exit the log mode.
|
||||
|
||||
Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.
|
||||
|
||||
Now we can login to the user with our private `MCC_Key` file.
|
||||
|
||||
Command:
|
||||
|
||||
```bash
|
||||
ssh -i <path to the MCC_Key private key> mcc@<ip here>
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
ssh -i MCC_Key mcc@3.71.108.69
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**
|
||||
|
||||
If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.
|
||||
|
||||
You can do `whoami` to see your username.
|
||||
|
||||
Now you can install .NET Core 6 and MCC.
|
||||
|
||||
### Installing .NET Core 6
|
||||
|
||||
> **ℹ️ NOTE: If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**
|
||||
|
||||
> **⚠️ WARNING: With newer versions of .NET Core 6 on Ubuntu 22.04 you might get the following error: `A fatal error occurred, the folder [/usr/share/dotnet/host/fxr] does not contain any version-numbered child folders`, if you get it, use [this solution](https://github.com/dotnet/sdk/issues/27082#issuecomment-1211143446)**
|
||||
|
||||
Log in as the user you've created.
|
||||
|
||||
Update the system packages and package manager repositories:
|
||||
|
||||
```bash
|
||||
sudo apt update -y && sudo apt upgrade -y
|
||||
```
|
||||
|
||||
Install `wget`:
|
||||
|
||||
```bash
|
||||
sudo apt install wget -y
|
||||
```
|
||||
|
||||
Go to your home directory with:
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
```
|
||||
|
||||
Download the Microsoft repository file:
|
||||
|
||||
```bash
|
||||
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Add Microsoft repositories to the package manager:
|
||||
|
||||
```bash
|
||||
sudo dpkg -i packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Remove the file, we do not need it anymore:
|
||||
|
||||
```bash
|
||||
rm packages-microsoft-prod.deb
|
||||
```
|
||||
|
||||
Finally, install .NET Core 6:
|
||||
|
||||
```bash
|
||||
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-6.0
|
||||
```
|
||||
|
||||
Run the following command to check if everything was installed correctly:
|
||||
|
||||
```bash
|
||||
dotnet
|
||||
```
|
||||
|
||||
You should get:
|
||||
|
||||
```
|
||||
Usage: dotnet [options]
|
||||
Usage: dotnet [path-to-application]
|
||||
|
||||
Options:
|
||||
-h|--help Display help.
|
||||
--info Display .NET information.
|
||||
--list-sdks Display the installed SDKs.
|
||||
--list-runtimes Display the installed runtimes.
|
||||
|
||||
path-to-application:
|
||||
The path to an application .dll file to execute.
|
||||
```
|
||||
|
||||
If you do not get this output and the installation was not successful, [try other methods](https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu#2204).
|
||||
|
||||
If it was successful, you can now install the MCC.
|
||||
|
||||
### Installing MCC on a VPS
|
||||
|
||||
Now that you have .NET Core 6.0 and a user account, you should install the `screen` utility, you will need this in order to keep the MCC running once you close down the SSH session (if you do not have it, the MCC will just stop working once you disconnect). You can look at the `screen` like a window, except it's in a terminal, it lets you have multiple "windows" open at the same time.
|
||||
|
||||
> **ℹ️ NOTE: There is also a Docker method, if you're using Docker, you do not need the `screen` program.**
|
||||
|
||||
You also can learn about the screen command from [this Youtube tutorial](https://youtu.be/_ZJiEX4rmN4).
|
||||
|
||||
To install the `screen` execute the following command:
|
||||
|
||||
```bash
|
||||
sudo apt install screen -y
|
||||
```
|
||||
|
||||
Now you can install the MCC:
|
||||
|
||||
- [Download a compiled binary](#download-a-compiled-binary)
|
||||
- [Building from the source code](#building-from-the-source-code)
|
||||
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)
|
||||
|
||||
How to use the `screen` command?
|
||||
|
||||
> **⚠️ WARNING: If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**
|
||||
|
||||
To start a screen, type:
|
||||
|
||||
```bash
|
||||
screen -S mcc
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**
|
||||
|
||||
> **ℹ️ NOTE: You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**
|
||||
|
||||
Now you will be in the screen, now you can start the MCC and detach from the screen.
|
||||
|
||||
To detach from the screen press `CTRL + A + D`.
|
||||
|
||||
To re-attach/return to the screen, execute the following command:
|
||||
|
||||
```bash
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:
|
||||
|
||||
```bash
|
||||
screen -d mcc
|
||||
```
|
||||
|
||||
To list out screens you can use:
|
||||
|
||||
```bash
|
||||
screen -ls
|
||||
```
|
||||
|
||||
To stop the MCC, you can hit `CTRL + D` (hit it few times).
|
||||
919
docs/el/guide/usage.md
Normal file
919
docs/el/guide/usage.md
Normal file
|
|
@ -0,0 +1,919 @@
|
|||
# Usage
|
||||
|
||||
How to run the program:
|
||||
|
||||
- [Running on Windows](#windows)
|
||||
- [Running on Linux, macOS](#linux-macos)
|
||||
- [Running using Docker](#docker)
|
||||
|
||||
Using the command line parameters:
|
||||
|
||||
- [Examples](#quick-usage-of-mcc-with-examples)
|
||||
- [Command line parameters](#command-line-parameters)
|
||||
- [Internal commands](#internal-commands)
|
||||
|
||||
## Windows
|
||||
|
||||
Simply run `MinecraftClient.exe`
|
||||
|
||||
> **ℹ️ NOTE: On Windows it's best using [Windows Terminal](https://docs.microsoft.com/en-us/windows/terminal/install) for the best experience and looks. Some features like emojis in the [`/chunk`](#chunk) command do not work in CMD or Powershell 5**
|
||||
|
||||
## Linux, macOS
|
||||
|
||||
To run the client you need to type the following command in your terminal emulator:
|
||||
|
||||
```bash
|
||||
./MinecraftClient
|
||||
```
|
||||
|
||||
If you want to keep it running in the background you can use `screen` (Linux only) Example:
|
||||
|
||||
```bash
|
||||
# Start the screen
|
||||
screen -S mcc
|
||||
|
||||
# Run it
|
||||
./MinecraftClient
|
||||
|
||||
# Detach from the screen by pressing CTRL + A + D
|
||||
|
||||
# Re-attach if you want to have accces again
|
||||
screen -r mcc
|
||||
```
|
||||
|
||||
_Learn more on how to use the screen command: [YouTube](https://www.youtube.com/watch?v=_ZJiEX4rmN4)_
|
||||
|
||||
## Docker
|
||||
|
||||
See [Run using Docker](./guide/installation.md#using-docker)
|
||||
|
||||
## Command-line usage
|
||||
|
||||
**Minecraft Console Client** has a plethora of useful command line parameters, here you can learn about them.
|
||||
|
||||
### For people not familiar with the command line
|
||||
|
||||
For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.
|
||||
|
||||
In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.
|
||||
|
||||
Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:
|
||||
|
||||
- `someparameter`
|
||||
- `-some-parameter`
|
||||
- `--some-other-parameter`
|
||||
- `--some-setting="some value"`
|
||||
- `-a=5`
|
||||
|
||||
Parameters with a single dash (`-`) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (`--`) are being used for parameters with a longer/full name.
|
||||
|
||||
When you are reading examples, you will often see something like this: `<something here>`, this means that this is a place holder and it should be changed with some value, excluding the `<` and the `>`.
|
||||
|
||||
For example `<username>` you need to change to an username of your liking, example: `notch` (`<` and `>` should not be included).
|
||||
|
||||
`[` and `]` mean that a parameter is an optional one.
|
||||
|
||||
They also can hold some values, example from the MCC:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
```
|
||||
|
||||
When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes (`"`), example: `--some-parameter="some text here with spaces in it"`
|
||||
|
||||
Here is an example for using a `--help` command line parameter for MCC that will print out a page on how to use MCC from the command line:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
```
|
||||
|
||||
### Quick usage of MCC with examples
|
||||
|
||||
> **ℹ️ NOTE: On Linux and macOS, you need to type: `./MinecraftClient` instead of `MinecraftClient.exe`**
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --help
|
||||
MinecraftClient.exe <username> <password> <server>
|
||||
MinecraftClient.exe <username> <password> <server> "/mycommand"
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
MinecraftClient.exe --section.setting=value [--other settings]
|
||||
MinecraftClient.exe <settings-file.ini> [--other settings]
|
||||
```
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
|
||||
MinecraftClient.exe notch password123 mc.someserver.com:25565
|
||||
|
||||
# Overriding a setting from MinecraftClient.ini using a command line parameter
|
||||
MinecraftClient.exe --debugmessages=false
|
||||
|
||||
# Providing a custom settings ini file and overriding a language to Chinese
|
||||
MinecraftClient.exe CustomSettingsFile.ini --language=zh
|
||||
```
|
||||
|
||||
### Rules of using the command line parameters
|
||||
|
||||
You can mix and match arguments by following theses rules:
|
||||
|
||||
- First positional argument may be either the login or a settings file
|
||||
- Other positional arguments are read in order: login, password, server, command
|
||||
- Arguments starting with `--` can be in any order and position
|
||||
|
||||
Examples and further explanations:
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server>
|
||||
```
|
||||
|
||||
- This will automatically connect you to the chosen server.
|
||||
- You may omit password and/or server to specify e.g. only the login
|
||||
- To specify a server but ask password interactively, use `""` as password.
|
||||
- To specify offline mode with no password, use `-` as password.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <login> <password> <server> "/mycommand"
|
||||
```
|
||||
|
||||
- This will automatically send `/mycommand` to the server and close.
|
||||
- To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini>
|
||||
```
|
||||
|
||||
- This will load the specified configuration file
|
||||
- If the file contains login / password / server ip, it will automatically connect.
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe --setting=value [--other settings]
|
||||
```
|
||||
|
||||
- Specify settings on the command-line, see possible value in the configuration file
|
||||
- Use `--section.setting=value` for settings outside the `[Main]` section
|
||||
- Example: `--antiafk.enabled=true` for enabling the `AntiAFK` bot
|
||||
|
||||
```bash
|
||||
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]
|
||||
```
|
||||
|
||||
- Load the specified configuration file and override some settings from the file
|
||||
|
||||
## Internal Commands
|
||||
|
||||
These commands can be performed from the chat prompt, scripts or remote control.
|
||||
|
||||
From chat prompt, commands must by default be prepended with a slash, eg. `/quit`.
|
||||
|
||||
In scripts and remote control, no slash is needed to perform the command, eg. `quit`.
|
||||
|
||||
> **ℹ️ NOTE: Some commands may not be documented yet or are defined in description of Chat Bots, use `/help` to list them all, or you can contribute to this page.**
|
||||
|
||||
### `animation`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Swing your main or off hand.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/animation <mainhand|offhand>
|
||||
```
|
||||
|
||||
### `bed`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to make the bot sleep easily, all about sleeping in one command.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `bed leave|sleep <x> <y> <z>|sleep <radius>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Leave a bed:
|
||||
|
||||
```
|
||||
/bed leave
|
||||
```
|
||||
|
||||
Sleep in a bed on 124 84 76:
|
||||
|
||||
```
|
||||
/bed sleep 124 84 76
|
||||
```
|
||||
|
||||
Sleep in a bed using relative coordinates:
|
||||
|
||||
```
|
||||
/bed sleep ~ ~ ~-2
|
||||
```
|
||||
|
||||
Automatically find a bed in radius of 50 blocks and sleep in it:
|
||||
|
||||
```
|
||||
/bed sleep 50
|
||||
```
|
||||
|
||||
### `bots`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/bots <list|unload <bot name|all>>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Unload a bot called CustomScript
|
||||
|
||||
```
|
||||
/bots unload CustomScript
|
||||
```
|
||||
|
||||
Unload all bots
|
||||
|
||||
```
|
||||
/bots unload all
|
||||
```
|
||||
|
||||
### `changeslot`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Change your selected slot in the hotbar.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/changeslot <1-9>
|
||||
```
|
||||
|
||||
### `chunk`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Displays the chunk loading status in a nice way.
|
||||
|
||||
> **⚠️ WARNING: To use this feature you need to enable the [Terrain and Movements](configuration.md#terrainandmovements)**
|
||||
|
||||
> **ℹ️ NOTE: You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: [`enableemoji`](configuration.md#enableemoji)**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/chunk status [chunkX chunkZ|locationX locationY locationZ]
|
||||
```
|
||||
|
||||
How it looks:
|
||||
|
||||
|
||||
|
||||
### `dig`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Dig a block on a specific coordinate.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dig <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dig 127 63 12
|
||||
```
|
||||
|
||||
Using relative coordinates:
|
||||
|
||||
```
|
||||
/dig ~ ~-1 ~2
|
||||
```
|
||||
|
||||
### `dropitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Drop all items of a specific type from your inventory.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/dropitem <itemtype>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All item types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs).**
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/dropitem diamond
|
||||
```
|
||||
|
||||
### `entity`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Attack an entity, use an entity or get a list of entities around you.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Entity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/entity <id|entitytype> <attack|use>
|
||||
```
|
||||
|
||||
Get a list of entities around you:
|
||||
|
||||
```
|
||||
/entity
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: All entity types can be found [here](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Mapping/EntityType.cs).**
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Attack a Zombie:
|
||||
|
||||
```
|
||||
/entity Zombie attack
|
||||
```
|
||||
|
||||
### `execif`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute a command if a specific condition is met.
|
||||
|
||||
The condition is a C# expression and the local variables you set using [`set`](#set), [`setrnd`](#setrnd) or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.
|
||||
|
||||
Also the instance of MCC is available with `MCC.`.
|
||||
|
||||
> **ℹ️ NOTE: All local variables are treated as strings in the app, when comparing their values, you can use `<variable> == "<value>"`, or better use [`.Equals`](https://www.programiz.com/csharp-programming/library/string/equals) method**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `/execif <condition (C# expression)> ---> <command>`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Setting a variable and using it:
|
||||
|
||||
```
|
||||
/set test=Something
|
||||
/execif test == "Something" ---> send Success!
|
||||
```
|
||||
|
||||
```
|
||||
/set test2=1
|
||||
/execif test2 == "1" ---> send Success 2!
|
||||
```
|
||||
|
||||
|
||||
Basic C# expression:
|
||||
|
||||
```
|
||||
/execif 1 + 2 + 3 == 6 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using MCC class:
|
||||
|
||||
```
|
||||
/execif MCC.GetHealth() == 20.0 ---> send Success!
|
||||
```
|
||||
|
||||
|
||||
Using in combination with [`execmulti`](#execmulti):
|
||||
|
||||
```
|
||||
/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3
|
||||
```
|
||||
|
||||
### `execmulti`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Allows you to execute multiple commands in succession on a single line, useful for debugging or when using [`execif`](#execif)
|
||||
|
||||
Commands are separated by `->`
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage: `execmulti <command 1> -> <command 2> -> <command 3> -> ...`
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/execmulti send 1 -> send 2 -> send 3 -> sneak
|
||||
```
|
||||
|
||||
### `quit`
|
||||
|
||||
- **Alias:** `exit`
|
||||
- **Description:**
|
||||
|
||||
Disconnect from the server and close the application
|
||||
|
||||
### `reco`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Disconnect and reconnect to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reco [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `reload`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Reloads settings from MinecraftClient.ini and Chat Bots.
|
||||
|
||||
> **ℹ️ NOTE: Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/reload
|
||||
```
|
||||
|
||||
### `connect`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Go to the given server and resume the script
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/connect <server> [account]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: `<server>` is either a server IP or a server alias defined in servers file, for more info check out [serverlist](configuration.html#serverlist)**
|
||||
|
||||
> **ℹ️ NOTE: `[account]` is an account alias defined in accounts file, for more info check out [accountlist](configuration.html#accountlist)**
|
||||
|
||||
### `script`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Run a script containing a list of commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/script <script name>
|
||||
```
|
||||
|
||||
### `send`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Send a message or a command to the server
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/send <text>
|
||||
```
|
||||
|
||||
### `respawn`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use this to respawn if you are dead (like clicking "respawn" in-game)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/respawn
|
||||
```
|
||||
|
||||
### `log`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Display some text in the console (useful for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/log <text>
|
||||
```
|
||||
|
||||
- Example:
|
||||
|
||||
```
|
||||
/log this is some text
|
||||
```
|
||||
|
||||
### `list`
|
||||
|
||||
- **Description:**
|
||||
|
||||
List players logged in to the server (uses tab list info sent by server)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/list
|
||||
```
|
||||
|
||||
### `set`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a value which can be used as `%variable%` in further commands
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/set <variable>=<value>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/set abc=123
|
||||
```
|
||||
|
||||
### `setrnd`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Set a `%variable%` randomly to one of the provided values
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/setrnd <variable> string1 "\"string2\" string3"
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/setrnd <variable> -7to10
|
||||
```
|
||||
|
||||
(Set a `%variable%` to a number from -7 to 9)
|
||||
|
||||
### `sneak`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle sneaking.
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/Sneak
|
||||
```
|
||||
|
||||
### `tps`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Get the server TPS (Ticks Per Second).
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/tps
|
||||
```
|
||||
|
||||
### `useitem`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Use item in the hand, this can be used to do a right click on items which open menus on servers.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useitem
|
||||
```
|
||||
|
||||
### `useblock`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Place a block from a hand on a specific coordinate or open an inventory:
|
||||
|
||||
- chest/trap chest
|
||||
- furnace
|
||||
- brewing stand
|
||||
- dispenser/dropper
|
||||
- hopper
|
||||
- shulker
|
||||
- loom
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) and [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **ℹ️ NOTE: Not all inventories have a GUI representation in an ASCII art format.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/useblock <x> <y> <z>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/useblock 43 72 7
|
||||
```
|
||||
|
||||
### `follow`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Make the bot follow a player.
|
||||
|
||||
> **ℹ️ NOTE: This command is avaliable only with [Follow Player](chat-bots.md#follow-player) Chat Bot enabled.**
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.** > **ℹ️ NOTE: You need to have [Enity Handling](configuration.md#entityhandling) enabled in order for this to work.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/follow <player name|stop>
|
||||
```
|
||||
|
||||
- **Example:**
|
||||
|
||||
```
|
||||
/follow milutinke
|
||||
```
|
||||
|
||||
### `wait`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Wait X ticks (10 ticks = ~1 second. Only for scripts)
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/wait <time>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/wait 20
|
||||
```
|
||||
|
||||
### `move`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for moving when terrain and movements feature is enabled.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Terrain and Movements](configuration.md#terrainandmovements) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Terrain and Movements](configuration.md#terrainandmovements) is currently not supported in `1.4.6 - 1.6`.**
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Enable gravity
|
||||
|
||||
```
|
||||
/move gravity on
|
||||
```
|
||||
|
||||
Move to coordinates:
|
||||
|
||||
```
|
||||
/move 125 72 34
|
||||
```
|
||||
|
||||
Move to a center of a block:
|
||||
|
||||
```
|
||||
/move center
|
||||
```
|
||||
|
||||
### `look`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for looking at direction when terrain and movements is enabled
|
||||
|
||||
- **Usage:**
|
||||
|
||||
```
|
||||
/look <x y z|yaw pitch|up|down|east|west|north|south>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
```
|
||||
/look up
|
||||
```
|
||||
|
||||
```
|
||||
/look east
|
||||
```
|
||||
|
||||
### `inventory`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Used for inventory manipulation.
|
||||
|
||||
> **ℹ️ NOTE: You need to have [Inventory Handling](configuration.md#inventoryhandling) enabled in order for this to work.**
|
||||
|
||||
> **⚠️ WARNING: The [Inventory Handling](configuration.md#inventoryhandling) is currently not supported in `1.4.6 - 1.9`.**
|
||||
|
||||
MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.
|
||||
|
||||
Inventory has slots and each one of them has an id.
|
||||
|
||||
> **ℹ️ NOTE: This command DOES NOT physically open a container (eg. chest), for that you need to use [`useblock`](#useblock) command first.**
|
||||
|
||||
An example of player inventory with annotated IDs in ASCII art and a list of items:
|
||||
|
||||
|
||||
|
||||
- **Usage:**
|
||||
|
||||
Basic usage:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: player and container can be simplified with p and c accordingly**
|
||||
|
||||
Actions:
|
||||
|
||||
- `click`
|
||||
- `shiftclick`
|
||||
- `drop`
|
||||
|
||||
Show/Preview items in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id>
|
||||
```
|
||||
|
||||
Click/Shift-Click on an item in an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: The default click is left click**
|
||||
|
||||
Close an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|container|<id>> close
|
||||
```
|
||||
|
||||
Drop item(s) from an inventory:
|
||||
|
||||
```
|
||||
/inventory <player|id> drop <slot id> <number of items|all>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To drop all items from a slot, you can use:** `all`
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive <slot id> <item type> <amount>
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete <slot id>
|
||||
```
|
||||
|
||||
Show all available inventories:
|
||||
|
||||
```
|
||||
/inventory inventories
|
||||
```
|
||||
|
||||
Search for an item of specified type in available inventories:
|
||||
|
||||
```
|
||||
/inventory search <item type>
|
||||
```
|
||||
|
||||
- **Examples:**
|
||||
|
||||
Show player's inventory:
|
||||
|
||||
```
|
||||
/inventory player
|
||||
```
|
||||
|
||||
Show/Preview items in an inventory using an id:
|
||||
|
||||
```
|
||||
/inventory 3
|
||||
```
|
||||
|
||||
Click on an item in player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player click 36
|
||||
```
|
||||
|
||||
Right-Click on an item in slot number/id `4` in an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 click 4 right
|
||||
```
|
||||
|
||||
Close an inventory with an id `2`:
|
||||
|
||||
```
|
||||
/inventory 2 close
|
||||
```
|
||||
|
||||
Drop a single item from a player's inventory in slot number/id `36`:
|
||||
|
||||
```
|
||||
/inventory player drop 36 1
|
||||
```
|
||||
|
||||
Drop all items from a player's inventory in slot number/id `37`:
|
||||
|
||||
```
|
||||
/inventory player drop 37 all
|
||||
```
|
||||
|
||||
Give an item to the player inventory from a creative menu when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativegive 36 diamondblock 64
|
||||
```
|
||||
|
||||
> **ℹ️ NOTE: To find item types, check out [this list](https://github.com/MCCTeam/Minecraft-Console-Client/blob/master/MinecraftClient/Inventory/ItemType.cs)**
|
||||
|
||||
Delete an item from a player's inventory in slot number/id `36` when in the creative mode:
|
||||
|
||||
```
|
||||
/inventory creativedelete 36
|
||||
```
|
||||
|
||||
Search for 10 Slime Blocks in available inventories:
|
||||
|
||||
```
|
||||
/inventory s SlimeBlock 10
|
||||
```
|
||||
|
||||
### `debug`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Toggle debug messages, useful for chatbot developers.
|
||||
|
||||
### `help`
|
||||
|
||||
- **Description:**
|
||||
|
||||
Show commands help.
|
||||
|
||||
> **ℹ️ NOTE: Use "/send /help" for server help**
|
||||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Add a link
Reference in a new issue