RCON.Net.Commands.Minecraft.Java 1.1.1

RCON.Net.Commands.Minecraft.Java

Minecraft Java Edition-specific RCON commands with full response parsing and typed result models.

Overview

RCON.Net.Commands.Minecraft.Java provides a comprehensive set of pre-built commands for interacting with Minecraft Java Edition servers:

• Player Commands - List, kick, teleport, and kill players
• Whitelist Management - Add, remove, enable/disable, and list whitelisted players
• Ban Management - Ban/pardon players and IPs with full list parsing
• Operator Management - Grant and revoke operator status
• Difficulty Controls - Set server difficulty level
• Server Commands - Version, save, and status commands
• Type-Safe Responses - Automatic parsing of server responses into strongly-typed models

Installation

Install via NuGet:

dotnet add package RCON.Net.Commands.Minecraft.Java

Dependencies

• RCON.Net.Core - Core RCON client library
• RCON.Net.Commands - Command base types

Quick Start

using RCON.Core;
using RCON.Commands.Minecraft.Java;

// Create and connect client
var client = RconClientBuilder.Create()
    .WithHost("127.0.0.1")
    .WithPort(25575)
    .WithPassword("your-password")
    .Build();

await client.ConnectAsync();

// Get server version
var versionCommand = ServerCommands.GetVersion();
var versionResponse = await client.ExecuteAsync(versionCommand.Build());
var version = versionCommand.Parse<VersionResult>(versionResponse);

// Get player list
var listCommand = PlayerCommands.GetList();
var listResponse = await client.ExecuteAsync(listCommand.Build());
var playerList = listCommand.Parse<PlayerListResult>(listResponse);

Console.WriteLine($"Players online: {playerList?.OnlineCount}/{playerList?.MaxCount}");
foreach (var player in playerList?.Players ?? Array.Empty<Player>())
{
    Console.WriteLine($"  - {player.Name} ({player.Uuid})");
}

await client.DisconnectAsync();

Command Categories

Player Commands (PlayerCommands)

// Get online players
var cmd = PlayerCommands.GetList();
var result = cmd.Parse<PlayerListResult>(response);

// Kick a player
var cmd = PlayerCommands.Kick("PlayerName", "reason");

// Teleport a player
var cmd = PlayerCommands.Teleport("PlayerName", 100, 64, -200);

// Kill a player
var cmd = PlayerCommands.Kill("PlayerName");

Whitelist Commands (WhitelistCommands)

// Add player to whitelist
var cmd = WhitelistCommands.AddPlayer("PlayerName");

// Remove player from whitelist
var cmd = WhitelistCommands.RemovePlayer("PlayerName");

// List whitelisted players
var cmd = WhitelistCommands.GetList();
var result = cmd.Parse<ListResult>(response);

// Enable/disable whitelist
var cmd = WhitelistCommands.EnableWhitelist();
var cmd = WhitelistCommands.DisableWhitelist();

// Reload whitelist
var cmd = WhitelistCommands.Reload();

Ban Commands (BanCommands)

// Ban a player
var cmd = BanCommands.BanPlayer("PlayerName", "reason");

// Pardon a player
var cmd = BanCommands.PardonPlayer("PlayerName");

// Ban an IP address
var cmd = BanCommands.BanIp("192.168.1.1", "reason");

// Pardon an IP address
var cmd = BanCommands.PardonIp("192.168.1.1");

// List banned players
var cmd = BanCommands.GetBannedPlayers();
var result = cmd.Parse<BanListResult>(response);

// List banned IPs
var cmd = BanCommands.GetBannedIps();
var result = cmd.Parse<BanListResult>(response);

Operator Commands (OpCommands)

// Grant operator status
var cmd = OpCommands.GiveOp("PlayerName");

// Revoke operator status
var cmd = OpCommands.RemoveOp("PlayerName");

Difficulty Commands (DifficultyCommands)

// Set difficulty
var cmd = DifficultyCommands.SetDifficulty(DifficultyLevel.Hard);
// Available levels: Peaceful, Easy, Normal, Hard

Server Commands (ServerCommands)

// Get server version
var cmd = ServerCommands.GetVersion();
var result = cmd.Parse<VersionResult>(response);

Response Models

Commands automatically parse responses into strongly-typed models:

PlayerListResult

public class PlayerListResult
{
    public int OnlineCount { get; set; }
    public int MaxCount { get; set; }
    public Player[] Players { get; set; }
}

public class Player
{
    public string Name { get; set; }
    public string Uuid { get; set; }
}

BanListResult

public class BanListResult
{
    public string[] Entries { get; set; }
}

ListResult

public class ListResult
{
    public string[] Players { get; set; }
}

OpResult

public class OpResult
{
    public string PlayerName { get; set; }
    public OpStatus Status { get; set; }
}

public enum OpStatus
{
    Granted,
    Revoked
}

DifficultyResult

public class DifficultyResult
{
    public DifficultyLevel Level { get; set; }
}

public enum DifficultyLevel
{
    Peaceful = 0,
    Easy = 1,
    Normal = 2,
    Hard = 3
}

VersionResult

public class VersionResult
{
    public string Version { get; set; }
    public int Protocol { get; set; }
}

Error Handling

Commands validate inputs and throw ArgumentException for invalid arguments:

try
{
    var cmd = PlayerCommands.Kick(null!); // Throws ArgumentException
}
catch (ArgumentException ex)
{
    Console.WriteLine($"Invalid argument: {ex.Message}");
}

Multi-Targeting

• .NET 8.0, .NET 9.0, .NET 10.0

Features

✅ Comprehensive Minecraft command library
✅ Type-safe response parsing
✅ Strongly-typed result models
✅ Input validation
✅ Async/await support
✅ Well-documented API

Minecraft Reference

Commands are based on official Minecraft server commands:

• Minecraft Wiki - Commands
• Minecraft Wiki - RCON

Related Packages

• RCON.Net - Core RCON client
• RCON.Net.Commands - Command base types

License

MIT License - See LICENSE file for details.