Difference between revisions of "Mods"

From Luanti Wiki
Jump to navigation Jump to search
(rename Minetest to Luanti)
 
(14 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Languages}}
+
{{Languages|nocat=1}}
  
<!--TOC-->
+
[[File:Mesecons example.jpg|thumb|An example of the mod [https://content.minetest.net/packages/Jeija/mesecons/ Mesecons].]]
{|align=right
+
'''Mods''' (short for '''modifications''' or '''modules''') are user-created modifications to a game in such a way that adds to or alters the gameplay. Some larger mods may add a lot of content to the game, while other smaller mods may add more settings/customization options or tweak the gameplay in small ways. [[Server]] mods or plugins mainly give server admins more options and ease of use, and all mods for singleplayer can also be used in multiplayer.
| __TOC__
 
|}
 
  
 +
While Luanti mods are generally safe to install as they run by default in a sandboxed environment, one should exercise caution with mods as they may modify your world data in an undesired way. A good way to protect your game from such problems is to regularily [[Backup Solutions|back up]] your world folder(s) when installing new mods.
  
<!--========================================================================================-->
+
To browse the selection of mods available for Luanti games, see [https://content.minetest.net/packages/?type=mod ContentDB].
  
= Mods =
+
__TOC__
  
<div style="float: left; width: 80%">
+
== Modpacks ==
 +
A modpack (short: “MP”) is a collection of mods to group them together. Basically, a modpack is just special directory containing the actual mod directories. It's purely a logical grouping and is done mostly for convenience and to group closely-related mods together. The main difference is that they will be displayed as a openable blue text item in the Luanti mod selector containing the component mods to allow granular control. Apart from that, there is nothing special about modpacks or mods inside a modpack. Individual mods in a modpack can still be enabled and disabled as if they were standalone mods.
  
[[File:Mesecons example.jpg|thumb|An example of a mod (here: Mesecons).]]
+
== Client-Side Mods ==
 +
A Client-Side Mod (short: “CSM”) is a mod used to customize your Luanti client. Client-Side Mods can be used when connected to a Luanti server because they are loaded locally. Client-Side mods require at least Minetest 0.4.15-dev from sources (note: Luanti was called “Minetest” back then), compiled after April 1st, 2017. Please note that the API is currently not stable and can change.
  
'''Mods''' ('''修改''' 或 '''模块'''的缩写) 是用户对游戏的修改,其添加或更改了游戏玩法。
+
== Finding mods ==
 +
Generally, all mods you would want are available on [https://content.minetest.net ContentDB] nowadays. They can be installed from the main menu by going to the <i>Content</i> tab and clicking on the <i>Browse online content</i> button.
  
一些较大的mod可能会为游戏添加很多内容,而其他较小的mod可能会添加更多设置/自定义选项,或者优化Minetest的速度,游戏玩法或图形。
+
For old or experimental mods, check the [https://forum.minetest.net/viewforum.php?f=46 Mods] subforum.
  
[[Server|服务器中的]] mod或插件主要为服务器管理员提供更多选择和易用性,单人游戏的所有mod也可以在多人游戏中使用。
+
== Installation ==
</div>
+
Starting with version 5.0.0, mods can be installed using the <i>Content</i> tab in Luanti.
<div style="clear: both"></div>
 
  
<div width: 100%">
+
To manually install content for Luanti, see [https://content.minetest.net/help/installing/ How to install content].
虽然Minetest Mod通常可以安全安装,为了保证安全,可以从[[ContentDB]]上安装mod,其中的所有Mod都经过了审核
 
  
但应谨慎使用Mod,以防止崩溃,系统不稳定,游戏/保存数据删除或由于链接错误或Mod本身而引起的潜在恶意软件感染。(几乎不可能)
+
== Creating mods ==
 +
Mods are written in the scripting language [https://www.lua.org/ Lua]. The official Lua API documentation can be found at [https://github.com/minetest/minetest/blob/master/doc/lua_api.txt lua_api.txt] or in HTML format [https://minetest.gitlab.io/minetest/ here].
  
保护您的游戏免受此类问题影响的一种好方法是,如果您选择使用mod,则备份Minetest文件夹。
+
=== Modding tutorials ===
 
+
* [https://rubenwardy.com/minetest_modding_book/en/index.html Minetest Modding Book] by [https://rubenwardy.com/ rubenwardy] with editing by [https://forum.minetest.net/memberlist.php?mode=viewprofile&u=19807 Shara].
有许多mod或插件可用来补充原始的[[Games/Minetest Game|Minetest game]],或为服务器管理员提供更多选择并管理其服务器。
+
* [https://dev.minetest.net/Modding_Intro Intro to modding on the developer wiki]
</div>
 
<div style="clear: both"></div>
 
 
 
 
 
<!--========================================================================================-->
 
 
 
= Modpacks =
 
<div style=" width: 100%">
 
 
 
一个modpack(简称:“ MP”)是将mod组合在一起的一组mod。基本上,modpack只是包含实际mod目录的特殊目录。
 
 
 
这纯粹是逻辑分组,主要是为了方便起见并将紧密相关的mod分组在一起。主要区别在于它们在Minetest中的mod管理器中将以不同的方式显示。
 
 
 
除此之外,modpack或modpack内的mod并没有什么特别的。仍然可以分别启用和禁用modpack中的各个mod,就像它们是独立的mod一样。
 
</div>
 
<div style="clear: both"></div>
 
 
 
 
 
<!--========================================================================================-->
 
 
 
= 客户端Mod =
 
<div style=" width: 100%">
 
 
 
客户端Mod(简称:“ CSM”)是用于自定义Minetest客户端的Mod。连接到Minetest服务器时可以使用客户端Mod,因为它们是本地加载的。
 
 
 
需要服务器允许
 
 
 
客户端mod至少需要Minetest 0.4.15-dev来自2017年4月1日之后编译的源代码。
 
 
 
请注意,API目前不稳定,可以更改。
 
</div>
 
<div style="clear: both"></div>
 
 
 
 
 
<!--========================================================================================-->
 
 
 
= 安装Mod =
 
从Mintest版本5.0.0开始,您可以从Minetest内部使用[[ContentDB]] from inside Minetest. Click on the “Content” tab in the main menu to find mods, games and texturepacks.
 
 
 
(备注:由于ContentDB服务器在国外,速度并不理想。一些镜像站点可能提供更好的速度,如http://45.195.153.173/)
 
(但它们不是官方的,Minetest开发组不对其安全性做保证)
 
 
 
<div style=" width: 100%">
 
 
 
''另请参阅 [[Installing Mods|安装Mod]] and [[Installing Client-Side Mods|安装客户端Mod]].''
 
</div>
 
<div style="clear: both"></div>
 
 
 
 
 
<!--========================================================================================-->
 
 
 
= Finding mods =
 
== 官方源 ==
 
 
 
* '''首选: [[ContentDB]].''' 在游戏中单击“内容” 标签以寻找Mods.
 
* [https://forum.minetest.net/viewforum.php?f=11 “ Mod Releases”子论坛]
 
* [https://forum.minetest.net/viewforum.php?f=9 “ WIP Mods”子论坛] (适用于尚未完成的Mod。这里有龙!)
 
* [https://forum.minetest.net/viewforum.php?f=53 “客户端修改”子论坛] (Only for client-side mods)
 
* [http://www.minetest.net/customize/#mods minetest.net上列出的Mod] (推荐查看!)(此列表不是最新的)
 
 
 
== 非官方源 ==
 
mods的非官方资源是:
 
 
 
* [http://krock-works.uk.to/minetest/modSearch.php Minetest Mod Search]
 
* [[Minetest Bower]]
 
 
 
= 编写Mod =
 
 
 
<div style=" width: 100%">
 
 
 
Mods是用 [https://www.lua.org/ Lua]编写的, 是一种相对简单的脚本/编程语言. 可以由能够在Lua中进行编码并了解Minetest的Lua API的任何人编写Mod。
 
 
 
可以在[https://github.com/minetest/minetest/blob/master/doc/lua_api.txt lua_api.txt]查看Lua API的官方文档。.
 
 
 
其他重要的学习资源:
 
* [http://rubenwardy.com/minetest_modding_book/ Minetest Mod编写在线教程] (强烈推荐)
 
* [http://dev.minetest.net/Intro Intro to modding] (on the developer wiki)
 
</div>
 
<div style="clear: both"></div>
 
 
 
 
 
<!--========================================================================================-->
 
 
 
= 列出服务器mod =
 
 
 
<div style=" width: 100%">
 
 
 
如果您在[[server|服务器]]上,则可以发出[[Server commands|命令]] <code>/mods</code>来查询服务器已安装mod的列表。
 
 
 
[[File:Modsonservers.png|1000px|big|middle|在多人服务器上使用最多的Mod at [http://servers.minetest.net/ servers.minetest.net] as of April 13th, 2020]]
 
</div>
 
<div style="clear: both"></div>
 
  
 +
== Listing actual running mods ==
 +
The ingame [[Server commands|server command]] <i>/mods</i> will list the active mods of the actual running game.
 +
[[File:Modsonservers.png|thumb|right|Most popular mods used on public servers listed at [https://servers.minetest.net servers.minetest.net] as of April 2020]]
 +
{{clear}}
  
 
[[Category:Mods]]
 
[[Category:Mods]]
 +
[[Category:Languages pages]]

Latest revision as of 20:39, 22 October 2024

Languages Language: English • Deutsch • español • français • italiano • 日本語 • Bahasa Melayu
An example of the mod Mesecons.

Mods (short for modifications or modules) are user-created modifications to a game in such a way that adds to or alters the gameplay. Some larger mods may add a lot of content to the game, while other smaller mods may add more settings/customization options or tweak the gameplay in small ways. Server mods or plugins mainly give server admins more options and ease of use, and all mods for singleplayer can also be used in multiplayer.

While Luanti mods are generally safe to install as they run by default in a sandboxed environment, one should exercise caution with mods as they may modify your world data in an undesired way. A good way to protect your game from such problems is to regularily back up your world folder(s) when installing new mods.

To browse the selection of mods available for Luanti games, see ContentDB.

Modpacks

A modpack (short: “MP”) is a collection of mods to group them together. Basically, a modpack is just special directory containing the actual mod directories. It's purely a logical grouping and is done mostly for convenience and to group closely-related mods together. The main difference is that they will be displayed as a openable blue text item in the Luanti mod selector containing the component mods to allow granular control. Apart from that, there is nothing special about modpacks or mods inside a modpack. Individual mods in a modpack can still be enabled and disabled as if they were standalone mods.

Client-Side Mods

A Client-Side Mod (short: “CSM”) is a mod used to customize your Luanti client. Client-Side Mods can be used when connected to a Luanti server because they are loaded locally. Client-Side mods require at least Minetest 0.4.15-dev from sources (note: Luanti was called “Minetest” back then), compiled after April 1st, 2017. Please note that the API is currently not stable and can change.

Finding mods

Generally, all mods you would want are available on ContentDB nowadays. They can be installed from the main menu by going to the Content tab and clicking on the Browse online content button.

For old or experimental mods, check the Mods subforum.

Installation

Starting with version 5.0.0, mods can be installed using the Content tab in Luanti.

To manually install content for Luanti, see How to install content.

Creating mods

Mods are written in the scripting language Lua. The official Lua API documentation can be found at lua_api.txt or in HTML format here.

Modding tutorials

Listing actual running mods

The ingame server command /mods will list the active mods of the actual running game.

Most popular mods used on public servers listed at servers.minetest.net as of April 2020