[新教程]客户端字库制作指南

祂的名字

测试效果如图



测试文件:
链接: https://pan.baidu.com/s/1U1VlyUf4Ye97TwXTG6TpIA?pwd=9hbg

一、阅读monogame的官方文档
这很重要,遇到问题从这里找.
https://docs.monogame.net/articles/getting_started/index.html

二、安装 .NET 8 SDK
建议下载dotnet-install脚本安装. 完成后可以在Powershell或者cmd中使用通过"dotnet --version"命令来确认.
https://dotnet.microsoft.com/en-us/download/dotnet/8.0
https://dotnet.microsoft.com/download/dotnet/scripts/v1/dotnet-install.ps1

三、创建MonoGame项目以及安装MGCB Editor

VS Code示例:

1.在VS Code中,按下键盘Ctrl + `打开终端窗口输入

dotnet new installMonoGame.Templates.CSharp 安装MonoGame 模板

2.添加扩展:
C# Dev Kit 、MonoGame Content Builder (Editor)、 MonoGame for VSCode
3.打开一个空文件夹,在终端窗口输入

dotnet new mgdesktopgl 创建Monogame项目


等待创建完成后右击Content中的Content.mgcb,选择Open in MGCB Editor


Visual Studio 2022示例:
1.确认包含必须的工作负载:Net desktop development(.Net桌面开发)
2.打开VisualStudio 2022选择继续但无需代码,通过控制台运行以下命令安装MonoGame模板

  dotnet new install MonoGame.Templates.CSharp
3.打开扩展 -> 管理扩展,搜索MonoGame


  MonoGame Framework C# projecttemplates
选择安装后关闭程序等待安装界面,安装完成后重新打开Visual Studio 2022

4.创建一个MonoGameWindows Desktop Application项目

按提示创建完成后,双击Content中的Content.mgcb
默认应该会使用MGCB Editor打开.如果并没有,你需要检查扩展,以及其他步骤是否正确,确认无误的话尝试用以下命令打开
dotnet tool install -g dotnet-mgcb-editor
dotnet tool restore
dotnet mgcb-editor

四、使用.spritefont文件构建.xnb

在MGCB Editor中右击Content选择Add,新建或者添加一份字体文件 SpriteFont Description

修改.spritefont,安装对应的字体或者将字体文件放到.spritefont所在的目录下,字体推荐阅读enderseven的相关教程

准备完成后,右击.spritefont,选择Rebuild开始构建即可

五、.spritefont模板

现在可以构建更加完整的字库了(虽然文件体积略大了一点点…但构建时间基本可以按秒算

1. <?xml version="1.0" encoding="utf-8"?>
   
2. 
   
3. <XnaContent xmlns:Graphics="Microsoft.Xna.Framework.Content.Pipeline.Graphics">
   
4. <Asset Type="Graphics:FontDescription">
   
5. 
   
6. <FontName>unifont-16.0.02</FontName>
   
7.   <!--字体名称, 拷贝字体文件名。-->
   
8. <Size>12</Size>
   
9.   <!--字体大小, 根据效果调整, 超出一定范围客户端会崩溃。-->
   
10. <Spacing>1</Spacing>
    
11.   <!--字体间距, 修改此值可以更改字符之间的间距量。-->
    
12. <UseKerning>false</UseKerning>
    
13.   <!--是否读取间距true/false。但我如果设置为true, 间距会出错, 搞不懂。-->
    
14. <Style>Regular</Style>
    
15.   <!--Style控制字体的样式。有效条目为"Regular"（常规）、"Bold"（粗体）、"Italic"（斜体）以及"Bold, Italic"（粗斜体），且区分大小写。-->
    
16. <DefaultCharacter>?</DefaultCharacter>
    
17.   <!-- 无法识别的默认字符 -->
    
18.   <CharacterRegions>
    
19.     <!-- ASCII 基本字符：包括空格、数字、大小写英文字母和常用符号 -->
    
20.     <CharacterRegion>
    
21.       <Start>&#x0020;</Start> <!-- 空格 -->
    
22.       <End>&#x007E;</End>   <!-- ~ 符号 -->
    
23.     </CharacterRegion>
    
24.    
    
25.     <!-- 常见标点符号 -->
    
26.     <CharacterRegion>
    
27.       <Start>&#x2000;</Start> <!-- 一些通用标点符号 -->
    
28.       <End>&#x206F;</End>
    
29.     </CharacterRegion>
    
30.    
    
31.     <!-- CJK 符号和标点 -->
    
32.     <CharacterRegion>
    
33.       <Start>&#x3000;</Start> <!-- 中文全角空格 -->
    
34.       <End>&#x303F;</End>   <!-- CJK 范围的标点符号 -->
    
35.     </CharacterRegion>
    
36. 
    
37.     <!-- 常用汉字：基本汉字范围 -->
    
38.     <CharacterRegion>
    
39.       <Start>&#x4E00;</Start> <!-- 第一个常用汉字“一” -->
    
40.       <End>&#x9FFF;</End>   <!-- 最后一个常用汉字 -->
    
41.     </CharacterRegion>
    
42.    
    
43.     <!-- 以下是一些可能不常用的汉字和符号，可以根据需求选择是否启用 -->
    
44.    
    
45.     <!-- 汉字扩展 A 区：不常见的汉字 -->
    
46.     <!-- 如果游戏不需要显示少数民族字符或历史汉字，可以去掉这一段 -->
    
47.     <CharacterRegion>
    
48.       <Start>&#x3400;</Start>
    
49.       <End>&#x4DBF;</End>
    
50.     </CharacterRegion>
    
51.    
    
52.     <!-- 半角和全角字符：这些字符通常用于特殊的排版或字符转换 -->
    
53.     <!-- 如果不需要全角字符或一些特殊符号，可以去掉这一段 -->
    
54.     <CharacterRegion>
    
55.       <Start>&#xFF00;</Start> <!-- 全角字符，如全角标点、英文字母和数字 -->
    
56.       <End>&#xFFEF;</End>
    
57.     </CharacterRegion>
    
58.    
    
59.     <!-- 拉丁补充字符：包括一些额外的常用字符，通常用于西欧语言 -->
    
60.     <!-- 如果只使用中文字符和标点，可以去掉这一段 -->
    
61.     <CharacterRegion>
    
62.       <Start>&#x00A0;</Start> <!-- 不换行空格 -->
    
63.       <End>&#x00FF;</End>   <!-- ÿ 字符 -->
    
64.     </CharacterRegion>
    
65.    
    
66.     <!-- 如果你只需要常见汉字和英文字符，可以将以上部分注释掉，加载更小的字符集 -->
    
67.    
    
68.   </CharacterRegions>
    
69. </Asset>
    
70. </XnaContent>

复制代码

六、可能存在的问题

1. 构建失败,提示********

请把你的字体文件*.otf *.ttf,放到.spritefont所在的目录下,复制该文件的名称(不加扩展名)

打开.spritefont文件, <FontName>粘贴</FontName>再重新构建
如果仍然失败,观察一下Rebuild选项是否在第三位?如果在倒数第三位那失败就很正常了,我在复现时直接打开MGCB Editor(没错我想偷懒),就存在这个问题,请按照流程在VS Code或者VisualStudio 2022中打开

如果依然失败,额…换个字体试试,或者万能的重启

2. 控制台或者终端运行dotnet指令报错

重新安装 .NET 8 SDK,建议下载dotnet-install脚本,右键使用PowerShell安装

https://dotnet.microsoft.com/download/dotnet/scripts/v1/dotnet-install.ps1

3. Visual Studio 2022的控制台中如果显示乱码,可以运行以下命令试一试
[Console]::OutputEncoding =[System.Text.Encoding]::UTF8

4. VSCode中没有Open inMGCB Editor 选项

请按要求添加所有拓展:
C# DevKit 、 MonoGame Content Builder (Editor)、 MonoGamefor VSCode