Skip to content
This repository was archived by the owner on Mar 4, 2026. It is now read-only.

Commit 7cfdbb1

Browse files
committed
docs: README.md 及 CONTRIBUTING.md 完善
1 parent 0db1e5c commit 7cfdbb1

2 files changed

Lines changed: 44 additions & 66 deletions

File tree

CONTRIBUTING.md

Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,36 @@
1-
敬请期待
1+
# 贡献指南
2+
3+
感谢您对 Minotaur 项目的兴趣!
4+
5+
欢迎任何人的贡献,无论是新手还是有经验的开发者。以下是一些关于如何开始贡献的指导。
6+
7+
## 开始之前
8+
9+
1. **了解项目**:请先阅读项目的 [README.md](README.md) 和其他文档,了解项目的目的和结构。
10+
2. **遵循行为准则**:请确保您的贡献符合我们的 [行为准则](CODE_OF_CONDUCT.md)
11+
12+
## 报告问题
13+
14+
发现了问题或有新的想法?请通过 GitHub Issues 提交。
15+
16+
1. **查找现有问题**:在提交之前,请搜索现有的问题,看看是否有人已经报告了相同的问题。
17+
2. **提供详细信息**:在报告问题时,请提供尽可能多的详细信息,包括错误消息、操作系统、版本号等。
18+
19+
## 贡献代码
20+
21+
想要为 Minotaur 项目贡献代码?请按照以下步骤操作:
22+
23+
1. **Fork 项目**:点击 GitHub 页面右上角的 "Fork" 按钮。
24+
2. **克隆您的 Fork**:在您的本地计算机上克隆您的 Fork。
25+
3. **创建新分支**:为您的修改创建一个新分支。
26+
4. **提交您的更改**:在新分支上进行修改,并提交您的更改。
27+
5. **发送 Pull Request**:返回您的 Fork 在 GitHub 上的页面,并点击 "New Pull Request" 按钮。
28+
29+
## 代码风格
30+
31+
请确保您的代码符合项目的编码风格和规范。
32+
33+
## 联系我们
34+
35+
如果您有任何问题或需要帮助,请通过以下方式与我取得联系:
36+
- 发送电子邮件至:kercylan@gmail.com

README.md

Lines changed: 8 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Minotaur 是一个基于Golang 1.20 编写的服务端开发支持库,其中
1212
mindmap
1313
root((Minotaur))
1414
/configuration 配置管理功能
15-
/game 游戏通用功能接口定义
15+
/game 游戏通用功能
1616
/builtin 游戏通用功能内置实现
1717
/notify 通知功能接口定义
1818
/planner 策划相关工具目录
@@ -21,7 +21,7 @@ mindmap
2121
/server 网络服务器支持
2222
/cross 内置跨服功能实现
2323
/router 内置路由器功能实现
24-
/utils 常用辅助函数包
24+
/utils 工具结构函数目录
2525
```
2626

2727
## Server 架构预览
@@ -63,7 +63,8 @@ chmod 777 ./local-doc.sh
6363
```
6464

6565
#### 文档地址
66-
**[http://localhost:9998/pkg/github.com/kercylan98/minotaur/](http://localhost:9998/pkg/github.com/kercylan98/minotaur/)**
66+
- **[http://localhost:9998/pkg/github.com/kercylan98/minotaur/](http://localhost:9998/pkg/github.com/kercylan98/minotaur/)**
67+
- **[https://pkg.go.dev/github.com/kercylan98/minotaur](https://pkg.go.dev/github.com/kercylan98/minotaur)**
6768

6869
### 简单示例
6970
创建一个基于Websocket的回响服务器。
@@ -87,69 +88,11 @@ func main() {
8788
访问 **[WebSocket 在线测试](http://www.websocket-test.com/)** 进行验证。
8889
> Websocket地址: ws://127.0.0.1:9999
8990
90-
### 事件
91-
`Miontaur` 中,绝大多数场景都采用事件注册的方式进行回调,可通过`XXX.RegXXXEvent`的方式进行事件注册,例如:
92-
```go
93-
package main
94-
95-
import (
96-
"github.com/kercylan98/minotaur/server"
97-
)
98-
99-
func main() {
100-
srv := server.New(server.NetworkWebsocket)
101-
srv.RegConsoleCommandEvent("command", nil)
102-
srv.RegStartBeforeEvent(nil)
103-
srv.RegStartFinishEvent(nil)
104-
srv.RegConnectionClosedEvent(nil)
105-
srv.RegConnectionOpenedEvent(nil)
106-
srv.RegConnectionReceivePacketEvent(nil)
107-
srv.RegReceiveCrossPacketEvent(nil)
108-
srv.RegMessageErrorEvent(nil)
109-
srv.RegMessageLowExecEvent(nil)
110-
}
111-
```
112-
其他的一些支持事件的结构体(非所有):
113-
- `game.Room` 游戏房间实现
114-
- ...
115-
### 可选项
116-
大部分的 `New` 函数均可使用可选项进行创建,具体函数前缀通常为 `With`
117-
```go
118-
package main
119-
120-
import (
121-
"github.com/kercylan98/minotaur/server"
122-
)
123-
124-
func main() {
125-
server.New(server.NetworkWebsocket,
126-
server.WithTicker(50, false),
127-
// ...
128-
)
129-
}
130-
```
131-
### 更多的网络模式
132-
```go
133-
package main
91+
### 持续更新的示例项目
92+
- **[Minotaur-Example](https://github.com/kercylan98/minotaur-example)**
13493

135-
import (
136-
"github.com/kercylan98/minotaur/server"
137-
)
138-
139-
func main() {
140-
server.New(server.NetworkTcp)
141-
server.New(server.NetworkTcp4)
142-
server.New(server.NetworkTcp6)
143-
server.New(server.NetworkUdp)
144-
server.New(server.NetworkUdp4)
145-
server.New(server.NetworkUdp6)
146-
server.New(server.NetworkWebsocket)
147-
server.New(server.NetworkKcp)
148-
server.New(server.NetworkUnix)
149-
server.New(server.NetworkHttp)
150-
server.New(server.NetworkGRPC)
151-
}
152-
```
94+
### 参与贡献
95+
请参考 **[CONTRIBUTING.md](CONTRIBUTING.md)** 贡献指南。
15396

15497
# JetBrains OS licenses
15598

0 commit comments

Comments
 (0)