Creating an Addon
This page either contains information that is only partially or incorrectly translated, or there isn't a translation yet.
If this page cannot be translated for some reason, or is left untranslated for an extended period of time after this notice is posted, the page should be requested to be deleted.
Also, please make sure the article complies with the alternate languages guide.
开始
请先确保您已经安装 Half-Life: Alyx 创意工坊工具集！
当您安装好工具集并且进入了工具集启动器（Workshop Tools），点击"Create New Addon"创建一个新的插件，输入名字，之后点击"Launch Tools"。
点击Create New Addon...
... 并且给它命名。
提示:如果您想要在不使用 VR 头显的情况下测试您的地图，不要勾选"Enable VR"。这不会改变您游玩的最终插件，它只是不启动 SteamVR 和让您在显示器上通过 WASD 和鼠标移动来测试调试版本的地图。您可以在每次启动工具集的时候勾选或者不勾选。创建地图
您已经做了个空插件，现在它需要内容！
注意:插件可以不只是包含地图 —— 实际上插件甚至不需要地图。插件可以是声音，模型，动画，纹理，不过最简单的使用插件的例子是使用地图，所以我们用它作为例子。想要了解更多请参阅一个插件的文件结构，或者浏览其他 Alyx 创意工坊工具的文档。当您加载好工具，点击位于左上角工具栏的 hammer 图标来打开 Hammer（Half-Life: Alyx关卡编辑器）。
您可以导入起始模板来替代从零开始创建地图。工具中还包括一张基本的入门地图。
- 在File菜单，选择New Map From Template。
- 转到maps\templates\并选择basic_setup.vmap
- 您打开的新地图应该像这样：
- 按下快捷键 Ctrl-S 或者File菜单的Save来保存您的地图。在这个例子中，以"example.vmap"来保存您的地图。
注意:想要要真正了解如何使用 Hammer，请尝试一些 SteamVR Home Hammer 教程和一些在 Half-Life: Alyx 上的示例地图。如果您想尝试构建地图并且四处走走，现在正是时候！
- 在构建之前，您需要生成预览光烘焙。
- 为了预览烘焙，去到 Lighting 菜单选择"Preview Baked Lighting"。在这个如此简单的地图上，这只需要花一点点时间。
注意:这里有更多关于 Half-Life: Alyx 光照和烘焙的信息。- 为了构建和游玩您的地图, 按下 F9 或选择 File 菜单上的 Build Map。 默认选择 Full Compile (完全编译)，这正是您想要的。点击 Build 按钮并等待 Hammer 构建您的地图。
- 游戏引擎窗口会出现在前台，并加载您的地图，您就知道构建完成了。如果您之前勾选了 Enable VR，戴上头显并四处走走！
将地图加入您的插件
Congratulations, you've made and built a map! Now it's time to formally add that map to your addon, so you can select the map from within Half-Life: Alyx's new game menu.
- Close the tools, and re-launch them to return to the Tools Launcher.
- Right-click your addon, or select it and press the gear icon, then choose "Edit Addon Info..."
In the window that pops up, click the + icon next to Maps, and add your test map by typing in its name. You don't need the file extension! These names are based on the file path starting at the maps directory, so since your test map is maps/example.vmap, you'd just type in "example." (If your map was located in maps/testmaps/example.vmap you would type in "testmaps/example")
In addition to editing addon info, the right-click menu contains some other useful options:
- Edit Addon Info...
- Once you've created maps for your addon, this is where you'll list them.
- Create Desktop Shortcut
- Places a shortcut on your desktop with the appropriate command switches to directly launch the tools with the appropriate addon. You can create separate shortcuts to launch your addon in tools with and without VR.
- Show Launch Command Line
- Shows you the command line string to launch directly into this addon's tools with your current launch options.
- Explore Content Folder & Explore Game Folder
- Opens a Windows Explorer window at the location of your addon's content directory (your source content, most of what you will be editing in tools), or game directory (your compiled content, and a few exceptions like LUA scripts and webm videos).
- Set As Default
- Marks an addon as default when launching the Half-Life: Alyx Workshop Tools. Default is saved between sessions.
- Duplicate
- Creates an addon with the desired name and copies the files from your selected addon into a new directory.
Play your addon
Now that you've made a map and added it to your addon, you can play it locally in game:
- Quit the tools and launch Half-Life Alyx normally from Steam.
- Go to the Addons menu. You should see your addon there, in the list of local addons. Make sure your addon is enabled.
- From the main menu, start a New Game.
- Click through the tabbed menu at the top of the New Game menu to change from the main Alyx campaign to Addon maps.
- Your addon should be there, ready to be played. Click it and start!
Upload your addon
Now that you've played your addon, if you think it's ready to be shared with the world, it's time to upload it in the Workshop.
Launch the Workshop Manager tool.
Select "New Submission."
Fill out the Publish dialog including a preview image, and hit submit.
提示:It's recommended to set your addon to Hidden or Friends-Only when you first upload, so you can test it with some privacy first. You can change this setting later.
Once your addon has been created and uploaded, the workshop web page for the addon will automatically open.
Update your addon
Launch the tools for your addon, as above. Go to the Workshop Manager tool, then right click the entry for your addon and select "Re-Upload."
注意:If you have multiple addons you should be sure to upload the active one!Type a description of what's changed into the Change Log, make whatever other changes you see fit to the Title, Description, and Preview Image, and hit Submit.