界面指南
介绍
本指南将通过5个课程帮助您了解NekoPlay界面。
开始之前
NekoPlay界面会根据您使用的设备自动调整。
无论布局如何变化,您总能找到以下元素:
1. 文本编辑器 - 编写脚本并定义游戏行为
2. 顶部工具栏 - 访问文件选项、设置、主题和帮助按钮?
3. 实时游戏画面 - 在开发过程中测试和查看游戏

NekoPlay有三种主要布局,会根据屏幕尺寸和方向自动调整:
· 横向(桌面或平板横屏)
· 纵向(手机和小屏幕设备)
· 中间(方形或中等尺寸屏幕)



游戏设置 →
游戏设置
首次进入NekoPlay时会出现此菜单来配置您的游戏。

1. 游戏名称
2. 游戏分辨率1
3. 分辨率预设
4. 像素平滑(抗锯齿)2
5. 导入游戏(".nkp"格式)3

预设窗口提供基于以下标准的预定义分辨率:
1. 分辨率
2. 宽高比
3. 标准尺寸
同时显示实时预览(4)



↑1. 分辨率
NekoPlay不使用固定的像素分辨率,而是基于资源尺寸工作。
↑2. 抗锯齿
抗锯齿是一种平滑图形边缘的技术,可消除"锯齿"或阶梯状外观,特别是在像素明显可见或图像缩放时。
↑3. ".nkp"格式
这是NekoPlay的官方格式,用于保存、导入或分享游戏。它是一个包含所有项目数据(场景、脚本、路径、配置等)的单一文件。
工具 →
工具
工具栏位于屏幕顶部。

此栏包含四个主要按钮:
文件
, 设置
, 主题
, ?

将鼠标悬停在任一按钮上会显示相应的子菜单。这些菜单在鼠标移开按钮和子菜单时会自动关闭。
文件
此菜单有4个选项:
新建、导入、保存和导出

新建
刷新页面并开始一个空项目。

导入
允许从设备上传.nkp
文件以加载已保存的项目。

保存
打开菜单将游戏本地保存为.nkp
文件

导出
启动客户端,可配置并下载游戏作为准备发布的HTML5项目。

设置
此菜单可调整工作环境和游戏参数:

游戏
更改游戏名称、基础分辨率、版本和平滑(抗锯齿)。

语言
选择界面语言:西班牙语、英语、葡萄牙语、日语、中文或韩语。

编辑器
通过调整字体大小或制表符/空格使用来自定义文本编辑。

主题
此菜单允许一键应用视觉样式:

?
帮助按钮,提供信息和外部链接。

从这里您可以:
▸ 访问官方维基和教程
▸ 查看关于引擎及其创建者的信息
▸ 阅读使用技术的详细信息
▸ 通过Ko-fi捐赠支持开发
文本编辑器 →
文本编辑器
文本编辑器有三个独立的输入字段,每个都有标明其用途的标签:
load
加载场景时只执行一次的代码
update
每帧执行的代码,适合移动逻辑或事件
script
用于可重用函数或不属于特定场景的逻辑的编辑器


默认情况下,您会看到与活动场景对应的load
和update
字段。
当选择编辑script
时,这两个字段会隐藏,只显示script字段。
您可以从顶部控制栏轻松在场景和脚本之间切换(下面解释)。
顶部控制栏

在文本编辑器上方有一个包含信息和按钮的栏
1. 您正在编辑的场景或脚本名称
2. 展开场景列表的按钮
3. 展开脚本列表的按钮
4. 如果您同时打开了一个场景和一个脚本,会出现第三个按钮,无需打开列表即可快速切换

场景和脚本列表


展开任一列表时,您会看到:

1. +
新建
2. ↑
导入
新建
打开菜单为新场景或脚本命名。
如果是场景,游戏显示会更新为空场景。

导入
允许分别上传.nkscene或.nkscript文件。

场景和脚本
列表中的每个场景或脚本包括:
1. 名称
2. 保存
3. 重命名
4. 删除

main场景很特殊:无法删除或重命名。您只能编辑或保存它。
文本编辑器
每个编辑器(load
, update
, script
)在右下角有两个按钮:
1. ⇄
同步
2. ⛶
全屏 / _
最小化

同步
保存更改并实时更新游戏。也可以按ctrl
+ s
。
全屏 / 最小化
将编辑器扩展至全屏以便舒适工作,或如果已扩展则最小化。

如果您编辑了某些内容但未同步,会注意到编辑器边框颜色变化,字段标签显示*表示有待保存的更改。
这帮助您快速查看是否有忘记保存的内容。

游戏画面 →
游戏画面
游戏显示区域是您在编辑时可以看到游戏实时运行的地方。这里会更新活动场景,让您可以立即测试对代码所做的更改。

调试按钮
这三个按钮允许您显示或隐藏可视化调试工具:

▧
边框
显示或隐藏游戏可见区域的边界。有助于理解场景的哪些部分在最终屏幕上可见。

▦
网格
显示或隐藏网格覆盖。有助于对齐元素和理解空间关系。

i
调试信息
显示或隐藏有关游戏性能和状态的技术信息。

控制按钮
这三个按钮控制游戏的执行状态:

↻
重启
从load
重新启动当前场景。
❚❚
暂停 / ▶
继续
停止或继续游戏执行。非常适合检查细节或帧行为。
⛶
全屏 / _
最小化
将游戏扩展至全屏或返回原始尺寸以获得更好的观看体验。

错误消息
同步代码时如果发生错误,NekoPlay会在游戏显示中显示调试消息。这让您无需中断工作流程就能快速发现问题。

最佳实践 →
最佳实践
虽然NekoPlay界面简单直观,但以下建议将帮助您充分利用它:
经常同步
使用⇄按钮或按Ctrl + S将代码与游戏实时同步。
如果您在编辑器名称旁看到星号(load*, update*, script*),表示有未保存的更改。
仅在需要时使用调试工具
调试工具(▧, ▦, i)在开发时非常有用,但如果一直开启可能会使视图混乱。
在进行视觉调整或检查游戏内部行为时再激活它们。
不要过度纠结分辨率
NekoPlay会根据玩家屏幕自动缩放游戏,所以您无需担心像素尺寸。
相反,应关注游戏在可见区域内的外观以及对象相对于网格的行为。
长代码编辑时使用全屏
如果代码很长,使用⛶按钮扩展编辑器。
这为您提供更多编写空间和专注力,在移动设备或小屏幕上特别有用。
单独保存场景和脚本
虽然您可以将整个项目保存为单个.nkp文件,但也可以单独保存场景(.nkscene)或脚本(.nkscript)。
这有助于备份、分享游戏部分内容或重用素材。
利用实时视图进行实验
您可以快速更改、同步并立即查看结果。
不要害怕不断尝试新想法。