mirror of
https://github.com/MCCTeam/Minecraft-Console-Client
synced 2026-08-15 13:04:36 +00:00
* feat: implement interactive TUI inventory viewer - Added InventoryTui command to open an interactive terminal user interface for inventory management. - Introduced InventoryApp and InventoryMainView classes for TUI layout and functionality. - Created InventoryViewModel and SlotViewModel to manage inventory data and display. - Integrated Consolonia for enhanced console UI experience. - Updated McClient to support console message handling during TUI operation. These changes enhance user interaction with inventory management in Minecraft Console Client. * feat: enhance debugging workflow with mcc-debug.sh and TUI support - Introduced mcc-debug.sh for streamlined one-step build, server start, and MCC launch. - Added TUI mode for improved user experience during debugging sessions. - Updated mcc-env.sh to include new debug helpers and TUI mode functionality. - Enhanced SKILL.md with detailed instructions for using the new debugging tools and console modes. These changes significantly improve the debugging process for Minecraft Console Client, making it more efficient and user-friendly. * feat: introduce TUI console backend and related enhancements - Added ClassicConsoleBackend and TuiConsoleBackend to support different console I/O modes. - Implemented IConsoleBackend interface for better abstraction of console operations. - Enhanced ConsoleIO to utilize the new backend structure for input and output handling. - Introduced MainTuiView and MccTuiApp for a full-screen TUI experience using Avalonia. - Updated InventoryTuiHost to manage TUI lifecycle and interactions. These changes significantly improve the console experience in Minecraft Console Client, providing a more flexible and user-friendly interface. * refactor: remove InventoryTui command implementation - Deleted the InventoryTui class, which provided an interactive terminal user interface for inventory management. - This change simplifies the command structure as part of ongoing improvements to the console experience in Minecraft Console Client. The removal of this command is aligned with recent enhancements to the console backend and user interface. * refactor: update InventoryMainView and MainTuiView for improved UI handling - Changed several fields from readonly to mutable in InventoryMainView to allow for dynamic updates. - Introduced a new McColorParser class for parsing Minecraft color codes and creating colored text blocks. - Enhanced MainTuiView to support formatted log lines and improved notification handling. - Updated chat scrolling behavior to ensure better user experience during text input and log display. These changes streamline the UI components and enhance the overall console experience in Minecraft Console Client. * feat: enhance command input handling in MainTuiView - Updated command input to use event routing for better key handling. - Added support for Ctrl key shortcuts to improve text manipulation (e.g., word deletion, caret movement). - Implemented text cleaning on input change to prevent newline characters. - Improved health and food status bar rendering with a new method for building bar text. These changes significantly enhance the user experience in the TUI by providing more intuitive command input functionality. * feat: enhance TUI command suggestion functionality - Introduced a new CommandSuggestion struct for backend-independent suggestion handling. - Updated ConsoleIO to streamline suggestion updates for both Classic and TUI backends. - Enhanced MainTuiView to display command suggestions with improved visibility and interaction. - Increased the maximum number of displayed suggestions from 6 to 10 for better user experience. These changes significantly improve the command input experience in the TUI, making it more intuitive and user-friendly. * feat: enhance offline command autocomplete functionality - Introduced an OfflineAutocompleteHandler to provide command suggestions for offline commands. - Added support for tab cycling through suggestions in the TUI. - Improved command input handling to clear suggestions when necessary and manage user input more effectively. - Updated TuiConsoleBackend to integrate with the new autocomplete feature. These changes significantly enhance the user experience by making command input more intuitive and responsive in offline scenarios. * feat: enhance localization and user feedback in TUI - Updated various TUI components to utilize localized strings for improved user experience. - Enhanced debug state output with translated labels for better clarity. - Improved inventory command help messages with localized text. - Added new translations for console mode descriptions and inventory viewer prompts. These changes significantly enhance the usability and accessibility of the TUI in Minecraft Console Client, making it more user-friendly and informative. * feat: enforce localization for user-facing strings in AGENTS.md - Added guidelines to ensure all user-facing text, including log messages and error messages, is managed through the translation system. - Specified the use of `Translations.resx` and `Translations.Designer.cs` for localization, emphasizing the importance of avoiding hardcoded strings in source code. These changes improve the consistency and accessibility of user-facing content across the application.
306 lines
9.3 KiB
C#
306 lines
9.3 KiB
C#
using System;
|
|
using System.Collections.Concurrent;
|
|
using System.Diagnostics;
|
|
using System.Runtime.InteropServices;
|
|
using System.Threading;
|
|
using Avalonia;
|
|
using Avalonia.Threading;
|
|
using Consolonia;
|
|
|
|
namespace MinecraftClient.Tui
|
|
{
|
|
/// <summary>
|
|
/// Console backend that uses Avalonia/Consolonia for a full-screen TUI.
|
|
/// Avalonia Dispatcher runs on the main thread; MCC logic runs on background threads.
|
|
/// </summary>
|
|
public class TuiConsoleBackend : IConsoleBackend
|
|
{
|
|
public event EventHandler<string>? MessageReceived;
|
|
public event EventHandler<ConsoleInputBuffer>? OnInputChange;
|
|
|
|
private MainTuiView? _view;
|
|
private volatile bool _readThreadActive;
|
|
|
|
public bool DisplayUserInput { get; set; } = true;
|
|
|
|
internal static TuiConsoleBackend? Instance { get; private set; }
|
|
|
|
/// <summary>
|
|
/// Initializes the Avalonia app and starts the main UI loop.
|
|
/// This blocks the calling thread until the TUI exits.
|
|
/// Before blocking, it starts MCC's remaining initialization on a background thread.
|
|
/// </summary>
|
|
public void RunTuiMainLoop(string[] args)
|
|
{
|
|
Instance = this;
|
|
|
|
AppDomain.CurrentDomain.ProcessExit += (_, _) => RestoreTerminalState();
|
|
|
|
System.Console.CancelKeyPress += (_, e) =>
|
|
{
|
|
e.Cancel = true;
|
|
var view = _view;
|
|
if (view != null)
|
|
Dispatcher.UIThread.Post(() => view.HandleCtrlC());
|
|
};
|
|
|
|
new Thread(() =>
|
|
{
|
|
Thread.Sleep(500);
|
|
ContinueMccStartup(args);
|
|
})
|
|
{ Name = "MCC-Main", IsBackground = true }.Start();
|
|
|
|
AppBuilder builder = AppBuilder.Configure<MccTuiApp>()
|
|
.UseConsolonia()
|
|
.UseAutoDetectedConsole()
|
|
.LogToException();
|
|
|
|
try
|
|
{
|
|
builder.StartWithConsoleLifetime(Array.Empty<string>());
|
|
}
|
|
finally
|
|
{
|
|
RestoreTerminalState();
|
|
}
|
|
}
|
|
|
|
private static volatile bool _terminalRestored;
|
|
|
|
private static void RestoreTerminalState()
|
|
{
|
|
if (_terminalRestored) return;
|
|
_terminalRestored = true;
|
|
|
|
try
|
|
{
|
|
System.Console.Write("\x1b[?1000l"); // disable X11 mouse
|
|
System.Console.Write("\x1b[?1001l"); // disable highlight mouse
|
|
System.Console.Write("\x1b[?1002l"); // disable button-event mouse
|
|
System.Console.Write("\x1b[?1003l"); // disable any-event mouse
|
|
System.Console.Write("\x1b[?1004l"); // disable focus events
|
|
System.Console.Write("\x1b[?1005l"); // disable UTF-8 mouse encoding
|
|
System.Console.Write("\x1b[?1006l"); // disable SGR mouse encoding
|
|
System.Console.Write("\x1b[?1015l"); // disable urxvt mouse encoding
|
|
System.Console.Write("\x1b[?1049l"); // leave alternate screen
|
|
System.Console.Write("\x1b[?25h"); // show cursor
|
|
System.Console.Write("\x1b[?7h"); // re-enable line wrap
|
|
System.Console.Write("\x1b[0m"); // reset attributes
|
|
System.Console.Write("\x1b[2J"); // clear entire screen
|
|
System.Console.Write("\x1b[H"); // cursor to home
|
|
System.Console.Out.Flush();
|
|
}
|
|
catch { }
|
|
|
|
if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
|
|
{
|
|
try
|
|
{
|
|
using var proc = Process.Start(new ProcessStartInfo
|
|
{
|
|
FileName = "stty",
|
|
Arguments = "sane",
|
|
UseShellExecute = false,
|
|
});
|
|
proc?.WaitForExit(500);
|
|
}
|
|
catch { }
|
|
}
|
|
}
|
|
|
|
private static void ContinueMccStartup(string[] args)
|
|
{
|
|
try
|
|
{
|
|
Program.ContinueAfterTuiInit(args);
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
ConsoleIO.WriteLineFormatted($"§c[MCC] Fatal: {ex.Message}");
|
|
}
|
|
}
|
|
|
|
internal void SetView(MainTuiView view)
|
|
{
|
|
_view = view;
|
|
}
|
|
|
|
internal MainTuiView? GetView() => _view;
|
|
|
|
public void Init()
|
|
{
|
|
}
|
|
|
|
public void WriteLine(string text)
|
|
{
|
|
var view = _view;
|
|
if (view == null)
|
|
{
|
|
System.Console.WriteLine(text);
|
|
return;
|
|
}
|
|
|
|
if (Dispatcher.UIThread.CheckAccess())
|
|
view.AppendLogLine(text);
|
|
else
|
|
Dispatcher.UIThread.Post(() => view.AppendLogLine(text));
|
|
}
|
|
|
|
public void WriteLineFormatted(string text)
|
|
{
|
|
var view = _view;
|
|
if (view == null)
|
|
{
|
|
System.Console.WriteLine(Scripting.ChatBot.GetVerbatim(text));
|
|
return;
|
|
}
|
|
|
|
if (Dispatcher.UIThread.CheckAccess())
|
|
view.AppendFormattedLogLine(text);
|
|
else
|
|
Dispatcher.UIThread.Post(() => view.AppendFormattedLogLine(text));
|
|
}
|
|
|
|
public void BeginReadThread()
|
|
{
|
|
_readThreadActive = true;
|
|
}
|
|
|
|
public void StopReadThread()
|
|
{
|
|
_readThreadActive = false;
|
|
DismissOverlay();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Close any open overlay (e.g. inventory) so the user can interact
|
|
/// with the main console again. Safe to call from any thread.
|
|
/// </summary>
|
|
internal void DismissOverlay()
|
|
{
|
|
var view = _view;
|
|
if (view == null) return;
|
|
|
|
if (Dispatcher.UIThread.CheckAccess())
|
|
{
|
|
view.HideOverlay();
|
|
}
|
|
else
|
|
{
|
|
Dispatcher.UIThread.Post(() => view.HideOverlay());
|
|
}
|
|
}
|
|
|
|
public string RequestImmediateInput()
|
|
{
|
|
if (_shutdownRequested)
|
|
{
|
|
Thread.Sleep(Timeout.Infinite);
|
|
return string.Empty;
|
|
}
|
|
|
|
var mre = new ManualResetEventSlim(false);
|
|
string? result = null;
|
|
|
|
void Handler(object? sender, string e)
|
|
{
|
|
result = e;
|
|
mre.Set();
|
|
}
|
|
|
|
MessageReceived += Handler;
|
|
mre.Wait();
|
|
MessageReceived -= Handler;
|
|
|
|
return result ?? string.Empty;
|
|
}
|
|
|
|
public string? ReadPassword()
|
|
{
|
|
return RequestImmediateInput();
|
|
}
|
|
|
|
public void ClearInputBuffer()
|
|
{
|
|
if (_view == null) return;
|
|
if (Dispatcher.UIThread.CheckAccess())
|
|
_view.ClearInput();
|
|
else
|
|
Dispatcher.UIThread.Post(() => _view?.ClearInput());
|
|
}
|
|
|
|
public void SetInputVisible(bool visible)
|
|
{
|
|
}
|
|
|
|
public void SetBackreadBufferLimit(int limit)
|
|
{
|
|
}
|
|
|
|
public void Shutdown()
|
|
{
|
|
_shutdownRequested = true;
|
|
RestoreTerminalState();
|
|
|
|
var lifetime = Application.Current?.ApplicationLifetime
|
|
as Avalonia.Controls.ApplicationLifetimes.IControlledApplicationLifetime;
|
|
|
|
if (lifetime != null)
|
|
{
|
|
if (Dispatcher.UIThread.CheckAccess())
|
|
lifetime.Shutdown();
|
|
else
|
|
Dispatcher.UIThread.Post(() => lifetime.Shutdown());
|
|
}
|
|
|
|
new Thread(() =>
|
|
{
|
|
Thread.Sleep(500);
|
|
Environment.Exit(0);
|
|
}) { Name = "TUI-Exit-Guard", IsBackground = true }.Start();
|
|
}
|
|
|
|
private volatile bool _shutdownRequested;
|
|
|
|
/// <summary>
|
|
/// Called from the TUI view when user presses Enter in the command input.
|
|
/// Always fires MessageReceived so that both the normal read-thread path
|
|
/// and RequestImmediateInput (used by offline prompt) receive the input.
|
|
/// </summary>
|
|
internal void OnCommandSubmitted(string command)
|
|
{
|
|
MessageReceived?.Invoke(this, command);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Called from the TUI view when user types in the command input.
|
|
/// </summary>
|
|
internal void OnInputChanged(string text, int cursorPos)
|
|
{
|
|
OnInputChange?.Invoke(this, new ConsoleInputBuffer(text, cursorPos));
|
|
}
|
|
|
|
internal void UpdateSuggestions(CommandSuggestion[] suggestions, (int Start, int End) range)
|
|
{
|
|
var view = _view;
|
|
if (view == null) return;
|
|
|
|
if (Dispatcher.UIThread.CheckAccess())
|
|
view.UpdateSuggestions(suggestions, range);
|
|
else
|
|
Dispatcher.UIThread.Post(() => view.UpdateSuggestions(suggestions, range));
|
|
}
|
|
|
|
internal void ClearSuggestions()
|
|
{
|
|
var view = _view;
|
|
if (view == null) return;
|
|
|
|
if (Dispatcher.UIThread.CheckAccess())
|
|
view.ClearSuggestions();
|
|
else
|
|
Dispatcher.UIThread.Post(() => view.ClearSuggestions());
|
|
}
|
|
}
|
|
}
|