first commit

This commit is contained in:
2026-08-28 19:44:46 +08:00
commit d99ccbbb0c
114 changed files with 16246 additions and 0 deletions
@@ -0,0 +1,81 @@
using FunGame.Server.Contracts.Gaming;
using FunGame.Server.Contracts.Networking;
using FunGame.Server.Contracts.Payloads;
using FunGame.Server.Contracts.Plugins;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
namespace FunGame.Server.Plugins.Example;
/// <summary>
/// 示例服务器插件(合并 v2 的 WebAPIPlugin 与 GameModuleServer)<para/>
/// - HTTP 端点:GET /plugin/example/hello<para/>
/// - WS 消息处理器:example.echo<para/>
/// - 对局模式:HandleGamingMessage(example.cheer)
/// </summary>
public class ExamplePlugin : IServerPlugin
{
private ILogger? _logger;
public string Name => "example";
public string Version => "1.2.0";
public string Author => "FunGame.Server";
public string Description => "示例服务器插件:演示 HTTP 端点、WS 消息处理器、对局模式与热重载";
public void OnLoad(IServiceProvider services)
{
_logger = services.GetService<ILoggerFactory>()?.CreateLogger("Plugin.example");
_logger?.LogInformation("ExamplePlugin v{Version} 已加载", Version);
}
public void OnUnload()
{
_logger?.LogInformation("ExamplePlugin 即将卸载(端点与消息处理器随后注销)");
}
public void ConfigureEndpoints(IPluginHttpHandlerRegistry http, IMessageHandlerRegistry messages)
{
// GET /plugin/example/hello
http.Register("GET", "hello", this, async context =>
{
await context.Response.WriteAsJsonAsync(ApiResponse.Success(new
{
message = "来自示例插件的问候(热重载后 v1.2.0)",
plugin = Name,
version = Version,
time = DateTime.Now
}));
});
// GET /plugin/example/info
http.Register("GET", "info", this, async context =>
{
await context.Response.WriteAsJsonAsync(ApiResponse.Success(new
{
name = Name,
version = Version,
author = Author,
description = Description
}));
});
// WS:example.echo —— 原样回显负载
messages.Register("example.echo", this, async (client, message) =>
{
return MessageEnvelope.Reply(message, message.Data);
});
}
public Task<Dictionary<string, object>?> HandleGamingMessage(IGameSession session, string type, Dictionary<string, object> data)
{
if (type == "example.cheer")
{
return Task.FromResult<Dictionary<string, object>?>(new Dictionary<string, object>
{
["message"] = $"插件 {Name} 收到对局消息(对局 {session.Id},回合 {session.Queue.TotalRound})"
});
}
return Task.FromResult<Dictionary<string, object>?>(null);
}
}