MinecraftConnection 2.0.0-preview1

This is a prerelease version of MinecraftConnection.
There is a newer version of this package available.
See the version list below for details.
dotnet add package MinecraftConnection --version 2.0.0-preview1
NuGet\Install-Package MinecraftConnection -Version 2.0.0-preview1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MinecraftConnection" Version="2.0.0-preview1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MinecraftConnection --version 2.0.0-preview1
#r "nuget: MinecraftConnection, 2.0.0-preview1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install MinecraftConnection as a Cake Addin
#addin nuget:?package=MinecraftConnection&version=2.0.0-preview1&prerelease

// Install MinecraftConnection as a Cake Tool
#tool nuget:?package=MinecraftConnection&version=2.0.0-preview1&prerelease

MinecraftConnection 2.0.0 - preview1

alternate text is missing from this package README image

Nuget (with prereleases) Nuget alternate text is missing from this package README image GitHub

日本語版はこちら

MinecraftConnection is a library for sending commands via RCON using C# to help you learn and automate your programming. It can be run on a vanilla server as well as a Spigot server, including plugins. Before running the program, you need to start a Minecraft server that allows RCON connections.

1. Preparation

First, download the Minecraft Server software and run it in any game directory. A server configuration file called server.properties will be created. Specify the password and port number for the RCON connection, and enable the connection.

Configuration example :

rcon.port=25575
rcon.password=minecraft
enable-rcon=true

After adding it save the file and restart the server. Launch Minecraft launcher and log in to the server.

2. Create Project

This library is intended for .NET Standard 2.1 and above. This section describes how to create a .NET 6 console application.

Install MinecraftConnection with the NuGet package manager, or run the following command in the package manager console.

Install-Package MinecraftConnection -Version 2.0.0-preview1

3. Sample programs

To run the program, start Minecraft Server and Minecraft itself (already logged in to the server). Top-level statements are used here.

3.1 Set the time to 0

using MinecraftConnection;

// IP address or DNS name.
string address = "127.0.0.1";
ushort port = 25575;
string pass = "minecraft";
MinecraftCommands command = new MinecraftCommands(address, port, pass);

command.TimeSet(0);

3.2 Set off fireworks

using MinecraftConnection;
using MinecraftConnection.Entity;

string address = "127.0.0.1";
ushort port = 25575;
string pass = "minecraft";
MinecraftCommands command = new MinecraftCommands(address, port, pass);

// Define the coordinates at which you want to launch
Position pos = new Position(-516, 64, -205);
// Make a fireworks
Fireworks fireworks = new Fireworks()
{
    LifeTime = 30, // Time to explosion
    Type = FireworkType.LargeBall, // Fireworks type
    Colors = FireworkOption.RandomColor(), // Fireworks color (RandomColor() is get random color)
    FadeColors = new List<FireworkColors> { FireworkColors.WHITE }, // after explosion color
};
// Set off fireworks at defined position
command.SetOffFireworks(pos, fireworks);

Result :

alternate text is missing from this package README image

Various fireworks can be set off depending on your ingenuity. If you would like to try it, please refer to this page.

https://zenn.dev/takunology/scraps/9462b03d13dd0a

4. Caution

The stop command is disabled due to the risk of stopping the server by RCON remote control. Executing the stop command in SendCommand method will raise an exception.


Project Detail: https://www.mcwithcode.com/

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.0 351 8/25/2023
2.0.2 382 4/9/2023
2.0.1 658 8/20/2022
2.0.0 457 8/20/2022
2.0.0-preview1 282 6/6/2022
1.1.1 659 2/15/2022
1.1.0 491 8/10/2021
1.0.1 387 8/9/2021
1.0.0 387 8/3/2021
1.0.0-beta2 302 7/18/2021
1.0.0-beta1 352 6/29/2021

Version 2.0.0 - preview 1

MinecraftConnection destructive changes were made. It is written differently than version 1. Documentation is still under construction.
Starting with 2.0.0, Minecraft now supports all languages, including Japanese, Chinese, Hindi, etc., as well as English in the Minecraft title display.