├── README.md ├── docs ├── Feed The Beast Wiki：Manual of Style.md ├── admin.md ├── bbs-laws.md ├── css │ └── code.css ├── data.md ├── editor.md ├── group.md ├── index.md ├── issues.md ├── itemrender.md ├── log.md ├── mod.md ├── recipe.md ├── styleguide.md └── user.md └── mkdocs.yml /README.md: -------------------------------------------------------------------------------- 1 | ## MC百科意见反馈区 2 | 3 | 意见反馈区迁移至这里，点击上边的`Issues`按钮进入反馈区 ~ 4 | 5 | 本区仅受理有关[MC百科](https://www.mcmod.cn)的BUG和意见，MC玩法相关提问请转到百科论坛[MOD讨论区](http://bbs.mcmod.cn/forum-31-1.html)。 6 | 7 | **反馈之前请先搜索是否有类似问题已被提出，避免重复！** 8 | 9 | MC百科文档：[http://help.qwq.fun/](http://help.qwq.fun/) 10 | 11 | 12 | ### 反馈流程 13 | 14 | 1. 首先请登录或者[注册](https://github.com/signup)一个GitHub账号。 15 | 2. 进入[意见反馈区](https://github.com/Ahrwing/mcmod/issues)，界面如下： 16 | ![](https://i.mcmod.cn/editor/upload/20210705/1625479072_14273_ycxp.png) 17 | 4. 首先搜索之前有没有类似问题提出过，需将搜索框中的`is:open`删除。 18 | 5. 如果没有类似问题，点击右上角的`New issue`按钮发起新的意见。 19 | 6. 进入之后你会看到编辑器界面： 20 | ![](https://i.mcmod.cn/editor/upload/20210705/1625480361_14273_KsAX.png) 21 | > GitHub 没有提供中文界面，上图中的文字是为了演示而后期合成的。 22 | 7. 把要展示的文件或图片通过拖拽、粘贴或点击下方的那行字来上传。 23 | 8. 编辑器使用 Markdown，一般来说不需要学习，提交 issue 时点击`preview`预览是否有不符合预期的内容即可。如有需要可以前往[菜鸟教程](https://www.runoob.com/markdown/md-title.html)学习。 24 | 9. 大家一起喵帕斯吧！ 25 | -------------------------------------------------------------------------------- /docs/Feed The Beast Wiki：Manual of Style.md: -------------------------------------------------------------------------------- 1 | # Feed The Beast Wiki:Manual of Style 2 | # Feed The Beast Wiki格式手册 3 | 4 | At the FTB Wiki, we try to keep a fairly consistent tone and style across our articles. It makes the wiki easier to read. This guide page outlines the general style used in the writing of pages and articles. If other guide pages would conflict with this, this page takes precedence. Changes made to this guide should reflect the general consensus, and should be first discussed on the Staff Noticeboard. 5 | 在FTB维基里，我们试图保证一种稳定的文章风格，使维基易于阅读。这个指南页面概述了编写页面和文章时候应当使用的风格。如果其他指南页面与此指南冲突，那么优先参考此页面的规则。对此指南的改动应当体现出大众意见，并且先在员工公告板上讨论。 6 | 7 | Use common sense while following this guide. There are occasions when certain rules should be ignored. 8 | 在参考此指南时请运用常识。在某些场合应当忽视掉部分准则。 9 | 10 | 11 | ## Rules of Thumb 12 | ## 基本准则 13 | 14 | + Use common sense. 15 | 运用常识。 16 | 17 | + If you need advice, ask a Staff member for advice. They are always welcome to help. 18 | 如果你需要建议，请咨询管理员。他们随时乐意帮忙。 19 | 20 | + Do not copy content from outside sources. Originality is greatly preferred. 21 | 不要从外部来源拷贝信息。强烈推荐原创内容。 22 | 23 | + Advertising, vandalism, and spamming are strictly prohibited. 24 | 严格禁止广告、蓄意破坏以及垃圾内容。 25 | 26 | + Articles should be simple, factual, and technical. Novels should be written elsewhere. 27 | 文章内容应当简明，符合事实且技术向的。不欢迎小说性质的内容。 28 | 29 | + Maintain a neutral point of view and encyclopedic tone. We are here for information, not demagoguery. 30 | 保持中立的观点和学术性的风格。我们是来编辑资料的，而不是来煽情的。 31 | 32 | + Use Templates when appropriate. All templates have documentation to explain their usage. Most machines have their own crafting grid templates; see the Crafting Grid Guide for more information. 33 | 在合适的时候使用模板。所有模板都有文档说明它们的用途。大多数机器拥有它们自己的合成表模板，参考“合成表指导”来获得更多内容。 34 | 35 | + When creating an article for an item, do not list all of its crafting uses; the FTB Wiki accepts it cannot compete against modern utilities like NEI in this area. However, a short description of its major uses is acceptable. 36 | 当为一件物品创建一个文章时，不要列出它所有的可合成列表（因为这样往往会大大扩展文章的长度）。FTB wiki在这方面可比不上NEI。但是一个关于其主要用途的说明是可以被接受的。 37 | 38 | + When referencing modpacks, please use the word "modpacks" not "mod packs", "mod-packs", etc. 39 | 40 | + When creating pages, use categories. Every page should fit within at least one category, and may be in more than one. 41 | 在创建页面时候，请注明它的类别。每一个页面都至少在一个类别中，也可能是多个。 42 | 43 | + Do not randomly create new categories; use common sense, and try to use the categories in place. If you feel a new category should be added, place a message on the article's Talk page or on the Staff Noticeboard. 44 | 不要随意创建新类别。动用常识，试着使用已有的适当的类别。如果你确定要添加一个新的类别，请先在文章的讨论区或者员工公告板里询问意见。 45 | 46 | 47 | ## Content policy 48 | ##内容政策 49 | 50 | ### Plagiarizing 51 | ### 抄袭、剽窃 52 | 53 | Creation of original content is by far preferable when creating articles. Plagiarism is strictly prohibited. Editors found to be plagiarizing will be warned for their first offense. 54 | 在编写文章的时候，强力推荐使用原创内容。严禁抄袭、剽窃行为。初犯者将会被警告。 55 | 56 | Copied content that falls under fair use may be used but must be properly cited. 57 | 可以使用合适的复制于其他地方的内容，但是必须正确注明引用行为。 58 | 59 | ### Vandalism 60 | ### 蓄意破坏 61 | 62 | Creation of empty pages, pages that contain nonsensical information, or pages that are blatantly and meaninglessly offensive, edits that deliberately disrupt other editors or readers, engaging in edit wars, flooding the recent changes, and creating misleading edit summaries are all considered vandalism. Editors that engage in vandalism will be blocked, usually for a week. 63 | 创建空页面、包含无意义内容或者引战性内容的页面，故意挑起其他编辑者或读者的矛盾，恶意刷编辑量，加入误导性内容等行为均被视作蓄意破坏。参与此类行为的编辑者通常会被ban掉大约一周左右。 64 | 65 | ### Spam and advertisement 66 | ### 垃圾信息与广告 67 | 68 | Spamming and advertising are strictly prohibited. Editors who post pages of spam or advertisement will be blocked. 69 | 垃圾信息与广告是被严格禁止的。任何提交了含有此类内容的编辑者都会被ban掉。 70 | 71 | ### Unofficial wikis 72 | ### 非官方wiki 73 | 74 | Hostility towards other wikis is not tolerated. Editors who make hostile comments about other wikis will be warned and may be blocked, and wiki staff members who do so will be suspended and blocked. 75 | 对于其他wiki的敌意行为是不可容忍的。对其他wiki发出敌意评论的编辑者会被警告，严重者会被ban掉，即便是wiki的员工犯下此类错误也会被除名并被ban。 76 | 77 | Linking to other wikis is not prohibited, if you feel that such links would contribute to the quality of the content. Interwiki links can be requested on the Project:Administrators' Noticeboard. 78 | 不禁止指向其他wiki的链接，如果你认为这样的链接对于提升编辑的质量有帮助的话。相关友链可以在“项目：管理员公告板”上找到。 79 | 80 | It is however recommended that editors only contribute to one wiki at a time, to ensure they do not inadvertently violate the copyright policies of the wikis they edit. 81 | 但是建议编辑者一次只引用一条wiki链接，以免无意间触犯所引用的wiki自己的版权政策。 82 | 83 | 84 | ## Article titles, headings, and sections 85 | ## 文章标题与段落格式 86 | 87 | Article titles and section heading should reflect the content they contain. Titles and section headings should be concise and precise. Titles should be consistent with the titles of related content. 88 | 文章标题和段落标题应当反映出它们将要叙述的内容。它们应当是简明扼要的。 89 | 90 | ### Article titles 91 | ### 文章标题 92 | 93 | + Capitalize letters in a title as they would be capitalized in a sentence. 94 | 95 | + The first letter of a title will always be automatically capitalized. 96 | 97 | + Articles on items should be titled exactly as the items appear in game. If multiple mods add items of the same name, append the full mod name in parentheses to the title. (For example, Wrench (BuildCraft)). 98 | 文章里的物品名称必须与它在游戏内的名称严格一致。如果多个mod添加了同名的物品，那么在标题里以括号形式附上完整的mod名称（如“扳手（BuildCraft）”） 99 | 100 | + Do not use A, An, The as the beginning of a title, unless it is an inseparable part of a name. 101 | 不要在标题的开头使用“一个”这样的词语，除非这是物品名称中不可分割的一部分。 102 | 103 | + Titles should not normally end in punctuation marks. 104 | 一般情况下不要在标题末尾加入标点符号。 105 | 106 | + Titles should not normally contain Unicode (non-alphanumeric or punctuation) characters. 107 | 一般情况下标题内不应包含Unicode字符。 108 | 109 | ### Section organization 110 | ### 段落组织 111 | 112 | An article must always start with an introductory lead section. The lead section must provide an overview of the entire article. A Table of Contents will be automatically inserted after the lead section if enough sections exist in the article. 113 | 一个文章必须以一段简介段落开头。此简介必须提供对整篇文章的概览。【若文章内有足够多的段落则会自动在简介之后插入一个目录】 114 | 115 | An article that expands upon a section may be linked with {{Main}} and related articles may be linked with {{See also}}. 116 | 由一个段落扩展而成的一个文章可以使用{{Main}}链接，与之相关的文章可以使用{{See also}}链接 117 | 118 | More information regarding the layout and order of sections can be found in the Project:Article creation guideline. 119 | 有关布局和段落顺序的更多内容请参见“项目：条目创建指南”。 120 | 121 | ### Section headers 122 | ### 段落标题 123 | 124 | + Capitalize letters in headings as they would be capitalized in a sentence. 125 | 126 | + Do not use links for headings or section titles. Use {{Main}} or {{See also}} to link to related content. 127 | 不要在段落标题内使用链接。使用{{Main}}或{{See also}}来链接相关内容。 128 | 129 | + Header titles can be separated from the equal signs by spaces or not separated. 130 | 标题可以通过空格符与等号分隔开。 131 | 132 | With spaces: == Recipe == 133 | Without: ==Recipe== 134 | 135 | + It is more important to keep consistency in an article than to follow your preferred method. 136 | 在文章里保证连贯性要比保持个人风格更重要。 137 | 138 | + Level 1 headings (= Level 1 heading =) must never be used. 139 | 禁止使用一级标题。 140 | 141 | + Section headings should be unique to avoid ambiguity in automatically generated edit summaries. 142 | 段落标题应当是相互独立的以免在自动生成的摘要里出现混淆。 143 | 144 | + Headings should not start with numbers or contain images. If absolutely required however, numbers may be used. 145 | 标题不应以数字开始或者包含图片。但是在特别要求的情况下，可以使用数字。 146 | 147 | ### Linking to sections 148 | ### 指向段落的链接 149 | 150 | Links can be created to link to specific sections by using #section name. To link to a section within the same page, use: [[#section name|]]; to link to a section on another page, use: [[Page title#section name|]]. Should a section name be repeated within an article, _2, _3 and so on will be appended to the anchor name to each subsequent appearances in the article. 151 | 可以使用#section name来创建链接以链接至指定段落。要创建一个指向页面内段落的链接，请使用[[#section name|]]；如果要链接另一个页面，请使用[[Page title#section name|]]。如果一个段落名称在文章内多次出现，应当在后面出现的名称里加入_2、_3这样的锚点。 152 | 153 | To avoid links being invalidated when a linked section's name is changed, it is recommended to add a comment in the section heading. For example: 154 | 为防止因段落名变更而导致的链接失效，建议在段落标题里加入注释。比如： 155 | 156 | == Heading == 157 | == 标题 == 158 | 159 | But not: 160 | 但不是这样： 161 | 162 | == Heading == 163 | == Heading == 164 | 165 | == 标题 == 166 | == 标题 == 167 | 168 | 169 | ## Text formatting 170 | ## 文本格式 171 | 172 | ### Title of works 173 | ### 文本标题 174 | 175 | + A title of a work should normally be italicized, but if the surrounding text is in italics, the title should be in a normal font. 176 | 文本标题通常情况下应当为斜体，但是若它的上下文已经是斜体则标题应用正常字体。 177 | 178 | + Titles of works should retain their capitalization regardless of other rules mentioned in this guide. 179 | 文本标题应当保留大写格式，这一点无需遵守本指南里其他的规则。 180 | 181 | ### Quotations 182 | ### 内容引用 183 | 184 | + Quotes should not be in italics. 185 | 引用内容不能使用斜体 186 | 187 | + Quotes should retain any errors, marked with {{Sic}} when appropriate, case and formatting. 188 | 引用时应当保留原文的可能的错误，并在适当的情况下使用{{Sic}}字段标记出来。 189 | 190 | + Quotes may be put in {{QuoteBox}} or {{Quote}} if long enough, or when appropriate. 191 | 如果引用的内容很长或者有其他特殊要求，应当使用{{QuoteBox}}或{{Quote}}字段来引用文本。 192 | 193 | ### Capital letters 194 | ###大写字母 195 | 196 | + Do not use capital letters for emphasis, please use *italics* or **bold**. 197 | 不要使用大写字母来强调重点，请使用*斜体*或**粗体**。 198 | 199 | Incorrect: DO NOT put your cat in the microwave. 200 | Correct: *Do not* put your cat in the microwave. 201 | 202 | + Do not capitalize the unless it is part or a proper noun or item name, in which case you must keep the original capitalization. 203 | 不要使用大写字母，除非是文本的一部分、专有名词或物品名（必须保留原有的大写字母）。 204 | 205 | Incorrect: Attacking The Enderdragon without proper gear may result in death. 206 | Correct: Going into The Nether without proper gear may result in death.[1] 207 | 208 | ### Boldface 209 | ### 粗体字 210 | 211 | + If the article title appears in the lead section, it may be highlighted with bold text. 212 | 如果条目标题出现在了简介段落，可以使用粗体来标记出来。 213 | 214 | Correct: **Wool** is a product you get from killing or shearing sheep with shears. 215 | 216 | + Bold can be used to indicate emphasis. 217 | 粗体字可以用来表示强调。 218 | 219 | ### Italic 220 | ### 斜体字 221 | 222 | + Italics can be used to indicate emphasis. 223 | 斜体字可以用来表示强调。 224 | 225 | + Titles of works should be in italics, but if the surrounding text is in italics, the title should not be in italics. 226 | 文本标题应当为斜体，但是如果上下文已经是斜体，则标题不要使用斜体。 227 | 228 | + Italics can be used to introduce new terms. 229 | 斜体字可以用来介绍新术语。 230 | 231 | + Foreign words (in the source language) should be in italics. However foreign proper nouns should not be in italics. 232 | 233 | Incorrect: ... *München* ... 234 | Correct: ... *in absentia* ... 235 | 236 | + Scientific names should be in italics. 237 | 学术名词应当使用斜体。 238 | 239 | ### Spacing 240 | ### 空格 241 | 242 | + A non-breaking space ( ) ensures that a line will not be broken at that point. 243 | 一个不换行空格符（ ）使得一行文字不会在空格处断开。 244 | 245 | + A number and its unit should not be on separate lines, using   can avoid them being separated. 246 | 数字以及它的单位不能被分行，使用 来避免这种情况。 247 | 248 | Correct: 10 blocks of Sand. 249 | 250 | ### Numbers and dates 251 | ### 数字与日期 252 | 253 | + If a number takes many words to type out, use figures instead. 254 | 如果一个数字使用文字表达过长，使用数字和符号表示。 255 | 256 | Incorrect: ten thousand and fifty six; 257 | Correct: 10,056; 1/12 one twelfth; 258 | 259 | + Delimit numbers over 4~5 digits with commas. 260 | 数字长度大于4或5位时使用逗号隔开. 261 | 262 | Correct: 1,234; 1234; 12,345 263 | 正确：1,234;1234,12,345 264 | 265 | + Retain in game formatting when possible. 266 | 如果可能，尽量与游戏内格式保持一致。 267 | 268 | 269 | ### Abbreviations 270 | ### 缩略语 271 | 272 | + Do not make up your own abbreviations. 273 | 不要使用自创的缩略语。 274 | 275 | + If an abbreviation will be used in an article, type out both the full name and the abbreviation the first time it would be abbreviated. 276 | 如果要在一篇文章里使用缩略语，在缩略语第一次出现的地方标注完整名称和它的缩写。 277 | 278 | Correct: ... Minecraft (MC) ... 279 | 如：...Minecraft (MC) ... 280 | 281 | + Mods commonly have abbreviations to ease editing on this wiki. Mod articles should mention these abbreviations. 282 | 在本wiki中为了方便编辑，mod通常都有自己的缩写。mod相关的条目应当提到这样的缩写。 283 | 284 | Correct: ... BuildCraft (referred on this wiki in templates as: BC) ... 285 | Correct: ... BuildCraft (commonly referred as BC) ... 286 | Correct: ... BuildCraft (BC) ... 287 | 正确：... BuildCraft (在本维基中简称为BC) ... 288 | 正确：... BuildCraft (通常缩写为BC) ... 289 | 正确：... BuildCraft (BC) ... 290 | 291 | + Plurals can be created by appending -s or -es and possessive forms can be created by appending -'s or -'. Do not use -'s to create plurals. 292 | 可以通过添加-s或-es来创建复数格式，以及添加-'s或-'来创建所有格。但是请不要使用-'s来表达复数格式。 293 | 294 | + To indicate approximately, c. is preferred over approx., ca. or circa. 295 | 如果要表明不确定性，推荐使用c.而不是approx., ca.或者circa. 296 | 297 | + Avoid using ampersands (&) to replace and. 298 | 避免使用"&"来替代"and"。 299 | 300 | Incorrect: ... Sand & Gunpowder makes TNT ... 301 | Correct: ... Sand and Gunpowder makes TNT ... 302 | 303 | 304 | ### Grammar and punctuation 305 | ### 语法和标点 306 | 307 | + Please do not contribute to the wiki without proper knowledge of English grammar. To find more information on English grammar, search "English grammar" on Google. 308 | 请不要使用不合乎语法的语句编辑wiki。（后略） 309 | 310 | + If you wish to contribute to the wiki but English is not your native language and you are not confident with using it, consider translating the wiki. 311 | 如果你想编辑wiki但英语不是你的本土语言，而你又不自信能使用好它，考虑翻译wiki吧。 312 | 313 | 314 | ### Wording and tone 315 | ### 用词与语气 316 | 317 | + Avoid double negatives. 318 | 避免双重否定。 319 | 320 | + Avoid using passive voice. 321 | 避免使用被动语气。 322 | 323 | + Use gender-neutral language when appropriate. 324 | 如果适合，使用中性语言。 325 | 326 | + Avoid using an instructive or presumptuous tone. A tone that addresses the reader or author directly is considered unencyclopedic. 327 | 避免使用说教式的或者专横的语气。直接针对读者或作者的语气也并不适用于维基。 328 | 329 | + Guides may have an exception to this. 330 | 此规则可能不适用于指南性质文章。 331 | 332 | Incorrect: Note that an icon appears at the bottom right of the screen showing... 333 | 错误：注意屏幕的底部右边有一个图标表示... 334 | 335 | Correct: An icon at the bottom right of the screen shows... 336 | 正确：屏幕底部右边的一个图标表示... 337 | 338 | + Informal text should be avoided. 339 | 避免使用非正式语句。 340 | 341 | + Long paragraphs and sentences should be shortened or split for clarity when appropriate. 342 | 适当的情况下，缩短或分割长段落和长句以增加可读性。 343 | 344 | + Remain in a neutral point of view. 345 | 保持中立观点 346 | 347 | + Use American English, such as armor rather than armour. Use British English by translating it. 348 | 349 | + All item names should remain in their exact spelling, even if it is incorrectly spelled, or uses non-American English. 350 | 所有物品名称均应保留其原始拼写，即便存在拼写问题或以非美式英语书写。 351 | 352 | Incorrect for American English: The **ArmourPieceItem** is an armour piece from that one mod. 353 | Correct for American English: The **ArmourPieceItem** is an armor piece from that one mod. 354 | 355 | 356 | ### Common examples of tone 357 | ### 有关语气的常见例子 358 | 359 | These are by no means strict rules, but they may provide some solutions in case you find yourself stuck fixing your tone. 360 | 在这方面规定并不严格，但是这些也许会在你组织语言的时候提供一些帮助。 361 | 362 | + You can do X thing with this block. 363 | 你可以做xxx的事情，使用这个方块。（错） 364 | + Instead, write The player can X with this block. 365 | 相对的，写成“玩家可以用这个方块做xxx。” 366 | 367 | + This is one of the first machines you will make in the mod. 368 | 这个是你在发展这个mod的时候，第一批需要造出的机器之一。（错） 369 | + Instead, write This is a low-tier machine, that is typically available early in the mod's progression. 370 | 相对的，写成“这是一台低阶机器，通常在发展mod的早期即可制造。” 371 | + **This sentence would be fine in a guide, but not a standard article.** 372 | **这样的句子可以放在指南里，但不适合一篇基础文章。** 373 | 374 | + Note that the machine can do this, but only under these circumstances 375 | 注意此机器可以做这些，但仅限以下这些场合 376 | + The machine is able to do this, but only under these circumstances 377 | 此机器能够做这些，但仅限以下这些场合 378 | 379 | If there are more examples needed, please contact a staff member. 380 | 如果需要更多的例子，请联系维基成员。 381 | 382 | 383 | ### Vocabulary 384 | ### 词汇 385 | 386 | **Never** correct grammar, spelling, or capitalization of in-game text. In-game text or item names should always be written exactly as it is in-game. This is stated several times in this manual. Instead of correcting grammar, use {{Sic}}, and consider letting the author of the content know that they have some misspellings, incorrect grammar, or capitalization issues. 387 | **永远不要**在文章里去更正引用的游戏内文本里的各种格式错误。游戏内文本或者物品名应当一直保持与游戏里的严格一致。这一点已经在本手册里多次提到。不过与其更正语法错误，还是使用{{Sic}}标记出来，并考虑通知内容的原作者有关格式错误的问题。 388 | 389 | + Use modpack instead of mod pack or mod-pack. 390 | 391 | + Use multiblock instead of multi-block or multi block. 392 | 393 | + When referencing the FTB Wiki Staff, use staff rather than team. This is mostly directed towards staff members. 394 | 当引用FTB Wiki的员工时候，请使用员工名而不是团队名。此处情况主要针对单独的员工。 395 | 396 | + Use addon instead of add-on. 397 | 398 | 399 | ## Linking 400 | ## 链接 401 | 402 | ### Wikilinks 403 | ### Wiki链接 404 | 405 | + Please create links when they are relevant to the content and helpful in context. 406 | 当链接与内容相关，并且可以增强文章连贯性时，加入它们。 407 | 408 | + Avoid making multiple links to the same page within a single article section. Linking to the same page in multiple separates sections is appropriate. 409 | 避免在一个页面的一篇文章的段落里加入多个链接。在多个不同段落分别添加指向同一页面的链接更加合适。 410 | 411 | + Avoid linking to disambiguation pages. Check the titles before linking to them. 412 | 避免链接到消歧页面。在链接到此类页面之前检查标题。 413 | 414 | ### External linking 415 | ### 外部链接 416 | 417 | Please avoid using shortened URLs unless necessary, as they can be used to cloak URLs that point to malicious websites and possibly lead users to sites they aren't expecting to enter. If shortened links are needed, please tag their use with {{Shortened}}. 418 | 除非必要，否则避免使用缩短的链接，因为这种链接掩盖了真实链接的指向页面，而这个页面可能是恶意的，或者用户不希望进入的。如果需要使用缩短版链接，请在使用了此链接的页面上加入{{Shortened}}标签。 419 | 420 | ### Category links 421 | ### 分类链接 422 | 423 | + Category links should be placed at the end of a page, but before the required final line, . 424 | 分类链接应当置于页面尾部，但是在要求的最后一行之前，加入标记以隔开分类链接和其他部分。 425 | 426 | + Please do not create new categories. If you cannot find an appropriate existing category, please post a request for a new category on the Staff Noticeboard. Redundant categories will be deleted without notice. 427 | 请不要擅自创建新分类。如果你没法在已有分类里找到合适的，请在“员工公告板”里提出添加新分类的请求。多余的分类将会在没有通知的情况下删除。 428 | 429 | ### Disambiguation pages 430 | ### 消歧页面 431 | 432 | + Use **unordered lists** to list different definitions. 433 | 使用无序列表来列出不同的释义。 434 | 435 | +Use **bold text** on a new line to categorize different types of definitions. 436 | 在新的一行使用粗体来分类不同的定义。 437 | 438 | + Do not link directly to disambiguation pages. Instead, link to the appropriate article. 439 | 不要直接链接向消歧页面。而是链接到合适的文章页面。 440 | 441 | + Articles with disambiguation pages should however use {{about}} to link to their own disambiguation pages. 442 | 但是具有消歧页面的文章应当使用{{about}}来链接到它们自己的消歧页面。 443 | 444 | ## Images 445 | ## 图片 446 | 447 | Images should be used to complement the article's content; such images should be right aligned. Images showcasing a build related to the article should be put at the end of the page as a gallery. Step-by-step images may be included on guide articles and on articles showcasing machine builds. Images mentioned above should contain captions to describe them. Captions are sentence fragments and should start with a capital letter and end without a period. 448 | 图片应当被用于补充文章内容；这样的图片格式上应当右对齐。展示建筑或构造的内容相关图片应当放置于页面底部的“画廊”里。指南性文章或者展示机器搭建的文章里可能包含步骤性的图片。以上提到的图片类型均应该附带注释。（之后略） 449 | 450 | Texture packs should never be used when obtaining screenshots. HUDs should be disabled when appropriate (default key is F1). 451 | 在截图时永远不得使用原版材质之外的材质。在必要的情况下装备栏显示应当被关闭（默认开关为F1）。 452 | 453 | Images of item icons and crafting recipes should not be uploaded to the wiki. To add a crafting recipe to an article, use a crafting grid template. For more information on using crafting grid templates, see the Crafting Grid Guide. Item icons are generated via the Tilesheet Extension. To add an item icon to the wiki tilesheets, or if an appropriate crafting grid template is not available, contact a Wiki Staff member. 454 | 物品图标和合成表相关图片不应上传至wiki。要给一篇文章添加一个合成配方，请使用合成表模板。有关使用合成表模板的更多信息请参见“合成表指南”。 455 | 456 | ### Image file names 457 | ### 图片文件命名 458 | 459 | Image file names should be descriptive; files with misleading titles will be deleted or moved. 460 | 图片文件名应当是符合图片的，具有误导性标题的文件将被移除。 461 | 462 | There are no naming conventions for images that exist on pages, however there are certain conventions for interface images. 463 | 对于已经存在于页面上的图片没有什么命名规定，但是对于界面图片还是有特定的规则的。 464 | 465 | Existing naming conventions: 466 | 已有的命名规则： 467 | 468 | Items in <> is required. 469 | 物品名应当放在<>内。 470 | 471 | Items in [] is optional. 472 | 物品名也可以选择放在[]内。 473 | 474 | + Crafting grid template backgrounds: GUI [mod name] .png 475 | 合成表模板背景文件：GUI [mod名称] <机器名>.png 476 | 477 | + Crafting grid tank overlays: GUI tank [width] .png 478 | 479 | + Crafting grid tank liquid: Liquid .png 480 | 481 | + Tilesheets: Tilesheet .png 482 | 483 | + For a list of mod abbreviations, see here. 484 | 要获取一份完整的mod缩写列表，请看这里。 485 | 486 | 487 | ### Copyrighted material 488 | ### 版权材料 489 | 490 | Please upload copyrighted material only if you are sure your use falls under fair use. Copyrighted content must be attributed on the file page unless the file is released to the public domain. 491 | 只有在确定没有滥用的情况下才可以上传版权材料。 492 | 493 | 494 | ## Videos 495 | ## 视频 496 | 497 | Linking to videos is heavily discouraged, and mostly not allowed. The reason for this is that the choice for the video creator may be biased, and may make the wiki look biased. Additionally, videos are often not 100% accurate, and are almost never up to date. If they are up to date, they will likely soon become outdated. 498 | 强烈不推荐指向视频的链接，通常情况下甚至禁止这样的做法。因为视频作者通常不会保持中立观点，这会影响维基风格。此外视频通常不会保证完全正确，而且几乎永远都不会赶上最新内容。即便它们赶上了也会很快过期。 499 | 500 | Do not use the wiki to promote channels or videos. 501 | 禁止使用维基来推广无关内容。 502 | 503 | 504 | ## Lists 505 | ## 列表 506 | 507 | + Avoid listing features of items as lists; present them with plain paragraphs when possible. 508 | 避免以列表方式列出物品的功能，尽量以普通段落描述之。 509 | 510 | + Do not leave a blank line between list items as the wiki will interpret them as separate lists. 511 | 不要在列表项目之间空行以免维基把它们误认为分开的列表。 512 | 513 | + Please add a space between the list item marker and the actual text item. 514 | 请在列表标记和正文之间空出一行。 515 | 516 | + Prefer an ordered list over an unordered list if the sequence is critical. 517 | 如果内容更具有连续性则更推荐有序列表。 518 | 519 | + Style and format should be consistent in a list. 520 | 列表内的格式应当保持一致。 521 | 522 | Incorrect: 523 | 错误： 524 | 525 | *Item A 526 | 527 | *Item B 528 | 529 | *Item C 530 | 531 | Correct: 532 | 正确： 533 | 534 | * Item A 535 | * Item B 536 | * Item C 537 | 538 | 539 | ## Wiki markup styling 540 | ## Wiki标记语法 541 | 542 | + The wiki markup is commonly referred as wikitext. A source of an article should be clear and easy to read. 543 | Wiki标记通常称为wikitext。一篇文章的源码应当是清晰且易于阅读的。 544 | 545 | + Use HTML markup sparingly. 546 | 少量使用HTML标记。 547 | 548 | + Prefer the use of Unicode characters over HTML entities. However sometimes HTML entities are better than Unicode characters. 549 | 推荐使用Unicode字符而不是HTML实体，虽然有时候后者要优于前者。 550 | 551 | + Avoid using excessive spacing. 552 | 避免使用过多空格。 553 | 554 | + An empty space between different sections may help editors identify a section break. 555 | 一个位于不同段落间的空白处也许有助于编辑者确定一个段落的分节点。 556 | 557 | + Avoid changing the font, style and color of text. 558 | 文本字体，颜色和其他格式应当保持始终一致。 559 | 560 | + If a section of wiki markup syntax looks strange, leave a comment on the article's talk page. 561 | 如果发现某一段维基标记语言的语法有点奇怪，在文章的讨论区留言。 562 | 563 | 564 | ## Translation 565 | ## 翻译 566 | 567 | *Main pages: Project:Translation guideline* 568 | *主页面：“项目：翻译指南”* 569 | 570 | + Translation Administrators are the only wiki users who should modify translation tags. 571 | 翻译区管理员是唯一一个允许更改翻译标签的wiki用户。 572 | 573 | + Please leave out any translation tags or elements on English pages. 574 | 请无视任何英语页面上的翻译标签或相关元素。 575 | 576 | + Note that the langbar () is **not** considered a translation tag. 577 | 注意语言栏标记（）**不**被认为是一种翻译标签。 578 | 579 | + If you are a translator, please only translate pages that are marked for translation. If no pages are available for translation, please request a page for translation on the Project:Translators' Noticeboard. 580 | 如果你是一名翻译人员，请只翻译那些标记了“翻译”的页面。如果没有页面可供翻译，请在“项目：翻译人员”的公告板下发出请求。 581 | 582 | + Language links ({{L}}) should only be used on articles marked for translation. 583 | 语言链接标记（{{L}}）只应当用于标记了“翻译”的文章。 584 | 585 | 586 | ## Templates 587 | ## 模板 588 | 589 | Main pages: Project:Template guideline 590 | 主页面：“项目：模板使用指南” 591 | 592 | ### Template markup 593 | ### 模板标记 594 | 595 | #### Links 596 | #### 链接 597 | 598 | Links in translatable templates should be changed to use the {{L}} language link template in order for it to link correctly on translated articles. 599 | 可翻译模板里的链接应当被更换成使用{{L}}标记的语言链接模板以正确指向翻译后的文章。 600 | 601 | ### Documentation 602 | ### 文档 603 | 604 | + Every template should have a documentation page (/doc) unless there exists a template that does similar things (in this case you could transclude the documentation for that template). 605 | 每个模板均应有一个文档页面（/doc）除非已经有一个起到类似作用的模板（这种情况下你可以将文档转移嵌入至那个模板） 606 | 607 | + Categorization of templates should be done on the documentation page using the {{TC}}. Only if that template has no documentation page can the template be categorized on the template page. 608 | 对模板的分类应当在文档页面使用{{TC}}标记完成。只有那些没有文档的模板才能在模板页面被归类。 609 | 610 | ### Navigation boxes 611 | ## 导航框 612 | 613 | + Most content articles should contain a Navigation box (Navbox). 614 | 大多数文章应当包含一个导航框(Navbox)。 615 | 616 | + Navbox items ({{NI}}) should be separated by a bold middot: {{,}}. 617 | 导航框里的条目（{{NI}}）应当用粗体逗号分隔开：{{,}}。 618 | 619 | + Navigation boxes do not replace the "See Also" section. 620 | 导航框不应取代“另请参见”栏。 621 | -------------------------------------------------------------------------------- /docs/admin.md: -------------------------------------------------------------------------------- 1 | # 后台使用教程 2 | 3 | ## 进入后台 4 | 5 | 使用后台，首先要保证你是编辑员，也就是用户组属于百科编辑员/资深编辑员！ 6 | 符合上述规则后，鼠标悬停于右上的用户名，下面出现的第一个链接就是后台了。 7 | 8 | ## 管理中心 9 | 10 | 这是后台主页，包含`常用链接`、`后台公告`、`联系方式`以及`编辑员列表`。 11 | 12 | ![image](https://user-images.githubusercontent.com/20513115/80804688-79c74f00-8be8-11ea-99f2-4a8ace297d21.png) 13 | 点击右侧`模组管理`、`GUI管理`、`资料管理`、`资料类型管理`（管理员另有`模组文件管理`）及其分条目，即可进入相关的功能区域。 14 | 15 | ## 模组管理 16 | 17 | ### 我的区域 18 | 19 | 此处会以ModID为顺序，列出编辑员所管辖范围内的所有Mod，并且在右侧提供了查看、编辑和删除功能。 20 | 21 | 注：资深编辑员 和 没有负责区域的百科编辑员 的负责区域，相当于所有Mod。 22 | 23 | ### 模组日志管理 24 | 25 | 此处可以更改Mod的日志排序。 26 | 点击上方选择需要日志排序的Mod，下面就会显示出来该mod的所有日志。之后又两种排序方法供选择： 27 | 28 | 1.自动排序：直接点击`ID`或者其他的表头，它就会变蓝且旁边出现箭头，日志也会以箭头所示方向（例如向下即升序）自动排列日志。GIF示例： 29 | 30 | ![](https://camo.githubusercontent.com/88151f3f80faa0590c3c10dd9c27def34071e6db/687474703a2f2f6262732e6d636d6f642e636e2f646174612f6174746163686d656e742f616c62756d2f3230313830372f32322f3134343131316a6a75693771783730376130616171752e676966) 31 | 32 | 2.手动排序：**鼠标按住**你要移动的日志条目，然后上下拖动（可以鼠标上下移动/滑动鼠标滚轮来拖动条目，也可以按`空格键`来迅速的把条目向下移动）条目并且**放开鼠标的按键**就可以使得日志被移动也就是排序了。GIF示例： 33 | 34 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/22/143529rodnpnvjvjkz385p.gif) 35 | 36 | 排列完成且保证无误后，点击最下的`确认排序`即可提交你的排序了。 37 | 38 | 注：只要手动选择了一个条目，就会出现`确认排序`；如果使用自动排序就不会给你在下方显示，但是可以手动选择之后再放回一个条目，这样会出现了。（Issue见# 524） 39 | 40 | ### GUI管理 41 | 42 | 此处可以查看、添加、编辑 编辑员负责区域 内所有Mod的GUI。 43 | 44 | 如果想要给自己负责的Mod添加GUI，点击左上处的`添加GUI`就会出现一个添加GUI的界面。首先应选择GUI所属的Mod，其次填入GUI的名称，这个名称会在合成表页面中部的`Mod设备`处显示，如图处： 45 | 46 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/22/214130upzfnsnsix5ixc4r.png) 47 | 48 | 旁边的，GUI对应资料ID就是这个合成GUI的来源方块。例如原版的烧制GUI来自于熔炉，那么这里就相应的填“熔炉“这个物品在百科的ID；但例如沉浸工程的[HOP石墨粉](https://www.mcmod.cn/item/30915.html)必须要工业挤压机这个多方块结构才能合成，那么这里就要填写“工业挤压机”这个多方块结构的ID。ID可于[资料列表](#%E8%B5%84%E6%96%99%E5%88%97%E8%A1%A8)查看。之后点击左下的`选择文件`上传你所做的GUI图片。 49 | 50 | 然后再分别添加*材料*、*成品*、燃料（随情况选择）物品格子，并使用鼠标、`WSAD`键、`上下左右键`和`Shift键`将其移动到GUI图片上相应的格子上。具体效果如图： 51 | 52 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/24/224023zv4ucd7i3nkdcqqv.png) 53 | 54 | **要求的效果是：物品格子 对齐并严格贴合 GUI的格子，位置正确，最后是保证合成表使用时不出现问题。** 55 | 56 | 如果你添加格子的时候不小心添加错了一个物品格子**想删除**，那么就双击此物品格子，它就会被删除。如GIF所示： 57 | 58 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/121100dxjz5cez1zv4yi4z.gif) 59 | 60 | 但是如果你GUI一次没有添加完**想隐藏格子**，那么就在右侧把没做完的格子的坐标改成(0,0)，此时**格子会保留，不会在 GUI管理的样式处和显示合成表时 显示，但会在添加/编辑合成表时显示**。具体效果如下列图： 61 | 62 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/121824vdzz5oy6yddztmtv.png) ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/121824tz19a3ligctniug6.png) ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/121948i1bplfmp66fp7fpw.png) ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/121824xkx53km663axo3sz.png) 63 | 64 | 注1：无论是材料、成品、燃料物品格子还是之后说到的能量条目，每个最多只能添加100个！但是目前无法在添加GUI时同时添加能量条目(见# 519) 65 | 66 | 注2：`上下左右键`或`WSAD键`只能把移动1像素，但按住Shift后就会移动10格。 67 | 68 | --- 69 | 70 | 当然对齐GUI上的格子是一个非常艰难的过程，此处提供一个对齐准确的方法： 71 | 72 | 1.将你要对其的（材料/成品/燃料）物品格子用鼠标大致移动到GUI所示格子处，如GIF所示： 73 | 74 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/23/172405fgjuwjhj5wsag85w.gif) 75 | 76 | 2.之后使用键盘来 水平或竖直 移动物品格子，当移动露出了1列白条（即1像素）时，再移动1像素完成，即使 *物品格子的相应侧边* 与 *GUI的格子的白色侧边* 严格贴合。如GIF所示： 77 | 78 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/24/233200i2uqagj17gjddab8.gif) 79 | 80 | 注：GUI上的这个白条基本上都是2像素的宽度，所以说如果那么再移动1像素即可。如果你的GUI不是的话，那么就继续移动，直到刚离开了白条（那时候也就是1像素），再移动回1像素即可。方法如GIF所示： 81 | 82 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/091637p5nrfs34q3rx1c71.gif) 83 | 84 | 当 添加并对齐完 物品格子之后，需要设置 各格子的属性，基本只有3种（燃料格子无需设置概率）： 85 | 86 | * 设置数量：即此格子是否允许设置物品的数量。如果不允许则数量默认为1；允许则编辑/添加合成表时，下面会给出数量设置（如下图） 87 | 88 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/24/235649d9uhkzhw0m3m3up0.png) 89 | 90 | * 设置概率：即此格子是否允许设置概率。如果不允许则默认设置为100%；允许则编辑/添加合成表时，下面会给出概率设置（如下图） 91 | 92 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/092357ea1q9q591qnw6936.png) 93 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/092357zfvqpiojfpdjjop2.png) 94 | 95 | 显示效果如下： 96 | 97 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/092850tj3ijg11jv2zopbo.png) 98 | 99 | 同时也允许使用概率来表示不消耗的物品。这时需要在相应物品的概率处填入"-1"即可。显示效果如下： 100 | 101 | ![](http://bbs.mcmod.cn/data/attachment/album/201810/14/162727s5ii8a8qa4n8g06n.png) 102 | 103 | ![](http://bbs.mcmod.cn/data/attachment/album/201810/14/162727hq1gpp8fzq68s8ls.png) 104 | 105 | * 单位：即此格子是否拥有单位。如果要设置的格子是类似流体槽等拥有单位的格子，则填入单位。之后编辑/添加合成表时，下面会给出设置，且显示时也会有相应调整。如下图： 106 | 107 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/113831rora70fa0wfbzz3r.png) 108 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/113829jx7g8fblb769bflg.png) 109 | 110 | 注：图1需要格子允许设置数量。 111 | 112 | 此外燃料格子需要单独来设置。燃料物品格子就是 GUI上用于放置燃料或者电池一类供能物品的格子 。每当你添加了一个燃料格子，左下就会出现一个框用于填写此处的资料ID，可于[资料列表](#%E8%B5%84%E6%96%99%E5%88%97%E8%A1%A8)查看。 113 | 114 | 完成这些之后，点击`提交添加`就可以提交你的GUI了。之后如果你想重新编辑GUI，那么点击左侧的`编辑`，就可以编辑你的GUI了 115 | 116 | --- 117 | 118 | 你已经提交了GUI了，所以就可以添加能量条目了。能量条目即是显示能量、时间或者电压等等等等这些数值的，它并不对合成表显示的内容进行影响，而只是作为数值来显示。最后效果可见下图： 119 | 120 | ![](http://bbs.mcmod.cn/data/attachment/album/201807/25/143904d6n6se2616ntwsao.png) 121 | 122 | ### 模组元素管理 123 | 124 | 此处可查看Mod元素信息，及包含该元素的Mod。 125 | 126 | ### MC版本管理 127 | 128 | 此处可查看MC百科所支持的所有MC版本，及版本所含Mod数量。 129 | 130 | ## 资料管理 131 | 132 | ### 资料列表 133 | 134 | 此处可以查看、移动、搜索、重命名Mod内的资料；对于物品/方块资料，可附有合并、综合的操作。 135 | 136 | 注：此处的资料是指[官方文档](http://help.qwq.fun/)内资料类型中的所有类型，它们都可以在此处更改。 137 | 138 | 想要查看Mod的某个资料类型里的资料，应选择Mod与资料类型，之后就会显示出此Mod相应资料类型下的所有资料；如果你是在查看`物品/方块`类型下的资料，那么还应相应选择其内部分类。之后就会显示里面资料的ID、名称、小图标、资料摘要和操作。操作对于全体资料都可以有选择、编辑和删除，对物品/方块资料，可附有选中且合并、综合或更改分类的操作。具体情况如图： 139 | 140 | ![](http://bbs.mcmod.cn/data/attachment/album/201808/13/195902z5zirtxcf4ciagiv.png) 141 | 142 | --- 143 | 144 | 想要排序资料，可以去看[日志排序](#%E6%A8%A1%E7%BB%84%E6%97%A5%E5%BF%97%E7%AE%A1%E7%90%86)的讲解，除了操作的条目变成了资料，其他内容都完全一样。 145 | 146 | 想要重命名资料，可以去看[资料分类管理](#%E8%B5%84%E6%96%99%E5%88%86%E7%B1%BB%E7%AE%A1%E7%90%86)的讲解，除了操作的条目变成了物品、没有了`改名`按钮、多了原名的更改之外，其他内容都完全一样。 147 | 148 | 想要查找某个资料，可以使用左上的搜索。但需要注意搜索是精准搜索，也就是只会搜索出名称/原名相符的资料；同时也提供有使用通配符进行模糊搜索的方式：使用“\*”以表示所有字符，例如搜索“\*石”会搜索出“末地石”、“钻石”等等；使用半角的“?”以表示一个字符，例如搜索“??石”会搜索出“铁矿石”、“煤矿石”等等。下方的 149 | `□不显示参与“合并”或“综合”的资料`选中之后不会出现 被 合并/综合 到的物品和 合并/综合 在上的物品，当然这些都只对`物品/方块`类型起效。 150 | 151 | --- 152 | 153 | （以下功能都是针对物品/方块资料，不再特殊说明） 154 | 155 | 想要将一堆资料结合起来，那么可以使`合并`和`综合`功能，二者的区别可以看下图： 156 | 157 | ![](https://admin.mcmod.cn/assets/img/diff.png) 158 | 159 | 合并是：有一堆子物品，那么选一个子物品并让其他的子物品结合到上面，这是合并； 160 | 161 | 综合是：有一堆子物品，编辑员随之添加一个父物品，那么把子物品结合到父物品上面，这是综合。 162 | 163 | 合并功能的介绍可以去[百科文档-资料添加/编辑教程-仅编辑员](http://help.qwq.fun/1835008#_67)处查看；下面会介绍综合功能。 164 | 165 | 综合功能上面已经解释了，是把子物品结合到父物品上，实际功能是：合并子物品到父物品上，在子物品的单页中引用父物品的介绍，在显示父物品分类的时候隐藏子物品和父物品的图标（看父物品单页的时候也会不显示图标，空内容的子物品不参与模组总填充率计算（父物品和有内容的子物品会算进）。 166 | 167 | **所以综合物品之后，分类显示一个父物品的名字和超链接是很正常的，同时想要查看子物品，点击旁边的查看！子物品并没有消失！** 168 | 169 | --- 170 | 171 | 想要合并物品，首先应该选中想要合并上的物品，然后左上方就会显示`选择项合并至物品ID`，将选择的首物品的物品ID填入，然后点击`合并`按钮并等待合并完成。 172 | 173 | 注：选中功能目前有些问题，具体可见#525。 174 | 175 | 想要综合物品，首先应该添加一个父物品在子物品们的分类里，它不需要有材质，原名和译名应该随子物品的名字决定。 176 | 177 | 例：在“发电机”分类里有 基础蒸汽轮机(Basic Steam Turbine)、进阶蒸汽轮机(Advanced Steam Turbine) 和 涡轮蒸汽轮机(Turbo Steam Turbine)，那么应该添加一个物品名字叫蒸汽轮机(Steam Turbine)。 178 | 179 | 之后去后台查询这个父物品的ID，然后选中想要综合上的物品，左上方就会显示`选择项综合至物品ID`，将父物品的物品ID填入，然后点击`综合`按钮并等待综合完成。 180 | 181 | 想要批量更改一些物品的分类，选中想要更改分类的物品，然后选择分类并点击`更改`按钮并等待更改完成。 182 | 183 | ### 资料分类管理 184 | 185 | 此处可以查看、更改、移动Mod的物品分类。 186 | 187 | 想要给一个Mod的分类改名，首先应在上方选择Mod，之后下方就会相应加载出其拥有的分类，之后手动分类就有两种选择： 188 | 189 | 1.双击想要改名的**分类的名字**，之后它就会变成一个可输入的文本框，此时更改分类的名字即可，更改完毕之后按`回车键`即可提交。如果错误的选择了分类，那么按`Esc键`就可以取消修改。 190 | 191 | 2.在要改名的分类右侧点击`改名`后，按上方方法1操作即可。 192 | 193 | --- 194 | 195 | 至于排序的内容可以去看[日志排序](#%E6%A8%A1%E7%BB%84%E6%97%A5%E5%BF%97%E7%AE%A1%E7%90%86)的讲解，除了操作的条目变成了分类，其他内容都完全一样。 196 | 197 | ## 文件管理 198 | 199 | ### 上传文件 200 | 201 | 点击 `选择文件并上传..` 即可上传Mod文件。(仅允许jar/rar/zip格式文件) 202 | 203 | 上传成功后需要填写Mod文件信息： 204 | 205 | - 选择Mod：在下拉列表中选择对应Mod，可搜索Mod ID(mid)，Mod中文名与Mod原名。 206 | - 所属MC原版版本：输入Mod文件对应MC版本。支持多版本时，当支持某一大版本中所有版本(如1.10与1.10.2)，则填入"1.10.x"，当支持某一大版本中部分版本，则用"/"分开。(如1.12/1.12.1) 207 | - 授权类型：授权通过某位百科用户与作者交流取得，即为 `手动授权` 。授权利用作者设置的开源协议，或作者主动提供授权，即为 `使用协议`。 208 | - 授权证明/说明楼：写明授权在[MOD下载区授权综合帖](https://bbs.mcmod.cn/thread-615-1-1.html)中的楼层链接。点击楼层号可直接复制楼层链接。 209 | - 取得授权人(仅手动授权)：写明取得授权的用户ID，即个人中心末尾数字。 210 | - 协议或特殊方式(仅使用协议)：写明何开源协议或选择作者亲自授权。 211 | 212 | ### 文件列表 213 | 214 | 点击下拉式选单后可选择需要排序的Mod，默认按照Mod ID排序。搜索框中可通过Mod名称、原名、缩写、Mod ID来搜索需要的Mod。 215 | 216 | 点击表头可自动排序，无法保证正确性，排序后请复查。 217 | 218 | 拖动项目即可排序单个文件。(GIF参考[模组日志管理](#模组日志管理)) 219 | 按住文件后可以通过 `鼠标滚轮`、`Page Up`、`Page Down`、`Home`、`End` 等方式来快速拖动文件至页首页尾等任何地方。 220 | 221 | 排序完成后需要点击末尾 `确认排序` 按钮，提交更改。 222 | 223 | 注意事项： 224 | 225 | 1. 文件排序规定为按照“MC版本 > 时间”的优先级排序，即先按照MC版本先后排序，再按照Mod文件更新时间排序。 226 | 2. `确认排序` 按钮目前至少需要一次排序操作才会显示。 227 | 3. 百科新上传文件不会置于第一位，而是默认第二位，因此每更新一个Mod的文件后都需要进行一次排序操作。 228 | 229 | ## 举报管理 230 | 231 | ### 短评举报 232 | 233 | 此处可以列出被举报的短评，但目前仅资深编辑员可以删除短评。 234 | 235 | ## 安全管理 236 | 237 | ### 访问状态 238 | 239 | 此处可以列出最近15分钟内百科访问量(连接数)，除搜索引擎蜘蛛外如发现连接数异常，需与重生联系。 240 | -------------------------------------------------------------------------------- /docs/bbs-laws.md: -------------------------------------------------------------------------------- 1 | 2 | ###水贴的定义### 3 | 4 | ###挖坟的定义### 5 | 6 | ###精品的定义### 7 | -------------------------------------------------------------------------------- /docs/css/code.css: -------------------------------------------------------------------------------- 1 | code,.rst-content tt { 2 | font-size: 100%; 3 | background: #F8F8F8; 4 | } 5 | 6 | p code { 7 | font-size: 80%; 8 | } 9 | 10 | table.docutils { 11 | text-align: center; 12 | } 13 | 14 | .wy-nav-content { 15 | padding: 1.618em 2.472em; 16 | } 17 | -------------------------------------------------------------------------------- /docs/data.md: -------------------------------------------------------------------------------- 1 | # 资料添加/编辑教程 2 | 3 | ## 进入添加资料页面 4 | 5 | 要想进入添加资料的页面，有两种办法： 6 | 7 | 第一种是点击任意模组下 `MOD资料` 内的 `添加新资料` 按钮： 8 | 9 | ![new 1](https://cloud.githubusercontent.com/assets/5229241/12670160/27b12058-c6a1-11e5-89f2-235957d3a7d4.png) 10 | 11 | 第二种是到任意资料页面下点击 `添加资料` 按钮： 12 | 13 | ![new 2](https://cloud.githubusercontent.com/assets/5229241/12670252/c8d4744e-c6a1-11e5-8166-2a1f9e867770.png) 14 | 15 | ## 进入修改资料界面 16 | 17 | 先进入想要修改的资料，点击资料上方的 `编辑` 按钮： 18 | 19 | ![edit](https://cloud.githubusercontent.com/assets/5229241/12676654/da685d92-c6ce-11e5-91c0-b761871e5829.png) 20 | 21 | ## 资料类型 22 | 23 | ![type](https://cloud.githubusercontent.com/assets/5229241/12670291/1bd36f6a-c6a2-11e5-9b93-1c989d3ed2d9.png) 24 | 25 | 资料类型暂时一共有10种，分别为： 26 | 27 | - **物品/方块**：例如石头、圆石、钻石等 28 | - **生物群系**：即Biome，例如草原、森林、沼泽等 29 | - **世界**：即维度(Dimension)，例如下界、末路之地、暮色森林等 30 | - **生物**：即Mob(注意不是Entity，Entity内容会扩充很多比如雪球和点燃的TNT等)，Mob是有AI的，例如牛、爬行者、僵尸等 31 | - **附魔**：即Enchantment，例如火焰保护、荆棘、时运等 32 | - **BUFF/DEBUFF**：即状态效果(Status Effect)，例如急迫、速度、缓慢等 33 | - **多方块结构**：由玩家搭建的多方块结构，搭建完成会形成一个整体工作，例如Thaumcraft 4中的炼狱熔炉、注魔台、荒古炼金炉等 34 | - **自然生成**：在世界中自动生成的多方块结构，例如沙漠神殿、丛林神庙、地牢等 35 | - **绑定热键**：即游戏的键位，例如跳跃、潜行、丢弃等 36 | - **天气效果**：例如降雨、降雪、雷暴等 37 | 38 | 除了 `物品/方块` 类型外其它类型的资料均只有 `基本信息` 和 `官方信息` 两项。注意切换类型的时候部分资料会被清空。 39 | 40 | ## 基本信息 41 | 42 | 以下内容中 `[资料]` 代表所选类型名称，例如选中 `世界` 类型时，名称为 `世界名称`。 43 | 44 | - **编辑器**：这里为资料的简介，请在这里描述资料的详细用途及数据。注意描述不要过于简单，一般情况下最好不要低于30个字。具体使用方法请查看[编辑器使用教程与准则](http://help.qwq.fun/1835006)。点击 `提交添加` 边上的 `预览内容` 可以预览编辑的结果。 45 | - **[资料]名称**：这里一般为资料的中文译名，但在无译名或译名不通用的情况下可以直接填写资料的原名。此项为必填项。 46 | - **[资料]原名**：这里为资料的原名，一般为英文。在资料名称已填写原名的情况下这一项可以空着不填。此项为选填项，但除了资料名称填写的是原名的情况以外，请务必认真填写，否则会对某些玩家产生误导。另外请注意原名一定要是原游戏中**显示**的名字，即大小写等格式要与游戏中一致。 47 | - **[资料]引用**：该项用于引用其他资料内容，避免重复复制粘贴。框内填写资料ID，点击可开启搜索框，搜索框中输入资料名称，选择所需项即可。引用内容以浅色边框形式置于资料底部，合成表顶部。 48 | - **[资料]封面**：此项仅在除 `物品/方块` 以外的类型中出现。这里填的是资料封面的地址，**请尽量使用百科站内地址**。封面分辨率为240x150，如果分辨率不对的话百科会自动进行拉伸。封面上传方式见下面的Note。生物的封面可以使用[ItemRender](https://www.mcmod.cn/class/175.html)进行导出，但是图片需要自己裁剪以符合分辨率，详细请见[ItemRender使用教程](http://help.qwq.fun/1835012)。此项为选填项，但为了资料的完善最好添加一下。 49 | - **物品/方块分类**：此项仅在 `物品/方块` 类型下出现。在这里请根据资料的功能/状态/主题等进行分类，默认为未分类状态。如果已有分类无法满足条件需要新建分类，请滑动到最下方选择自定义，并在右方的方框中填写新的分类。在新建分类前请先检查当前资料是否能归属到已有分类当中。如果Mod中有对资料进行分类(创造面板或子Mod等),请按照Mod中的相应分类添加。 50 | 51 | ## 拓展信息 52 | 53 | 此项仅在 `物品/方块` 类型下出现。 54 | 55 | - **矿物词典**：如果该物品支持Forge Oredict，请搜索并选择相应的矿物词典项。注意目前百科的矿物词典项并不完善，目前只能选择少数的几个矿物词典项，所以如果没有搜索到请空着或找编辑员添加。目前只有编辑员能够添加与修改矿物词典条目，所以如果想要添加矿物词典请联系编辑员。此项为选填项。 56 | - **最大耐久**：此项为物品的最大耐久度，例如钻石剑为1562。该项可以用ItemRender导出之后查看导出json中物品的对应 `maxDurability` 项，具体请看[ItemRender使用教程](http://help.qwq.fun/1835012)。如果没有最大耐久可以留空，此项为选填项。 57 | - **最大叠加**：该项为物品的最大叠加数，即一个格子内最多能放的物品数，例如石头为64，钻石剑为1。该项可以用ItemRender导出之后查看导出json中物品的对应 `maxStackSize` 项，具体请看[ItemRender使用教程](http://help.qwq.fun/1835012)。该项为选填项。 58 | - **完整采集**：该项为最低能够完整采集物品而不会将其破坏掉的工具的ID。例如煤矿为木镐，铁矿为石镐。注意这里要填的不是工具名称而是ID，ID可在网址中找到，比如石头的网址为 `http://www.mcmod.cn/item/8.html`，那么石头的ID就为8。当然，此项自带了搜索框，你可以在搜索框中搜索资料的名称。在输入框右边有一个常用工具ID，在里面可以选择一些常用工具的ID从而加快效率。此项为选填项，如果没有特殊的工具要求请留空。 59 | - **图标**：图标分为大图标和小图标，大图标为128x128，小图标为32x32。图标可用ItemRender导出，具体请看[ItemRender使用教程](http://help.qwq.fun/1835012)。非必填项。上传方式有两种： 60 | - 第一种方式为文件上传，步骤为 `选择文件` -> `打开`。如果使用ItemRender导出的话，小图标带 `_grid` 后缀，大图标无后缀。 61 | - 第二种方法为Base64码上传，步骤为 `显示base64` -> 粘贴Base64码。Base64码可使用ItemRender导出json之后在相应json文件内找到对应物品的 `smallIcon` 和 `largeIcon` 项。 62 | - 如果两个都传了，优先显示Base64的图标。因此如果出现上传图片但图标未更改，请优先检查base64码是否已清除。 63 | 64 | ## 官方信息 65 | 66 | - **首次出现**：该资料首次出现时的MOD版本，如果没有找到相应的版本可以点击右边的 `添加MOD更新日志` 按钮添加新的日志，添加日志请看[日志添加/编辑教程](http://help.qwq.fun/1835009)。切勿无考据乱填。 67 | 68 | ## 仅编辑员 69 | 70 | 此项仅在 `物品/方块` 类型下出现，并且只有编辑员才能看到。 71 | 72 | - **合并物品/方块**：这里填写合并**至**物品的ID，ID可在网址中找到，比如石头的网址为 `https://www.mcmod.cn/item/8.html`，那么石头的ID就为8。当然，此项自带了搜索框，你可以在搜索框中搜索资料的名称。如果当前资料与另外一个资料功能相近，这两个资料合并后将在合并**至**物品的页面中显示两个物品的介绍，在**被**合并物品页面中会显示合并**至**物品的链接。比如粉碎铜矿石可以合并至铜矿石，效果见[铜矿石](https://www.mcmod.cn/item/78.html) 73 | - **另外版本(已移除)**：这里填写另外版本物品的ID，ID可在网址中找到，比如石头的网址为 `https://www.mcmod.cn/item/8.html`，那么石头的ID就为8。当然，此项自带了搜索框，你可以在搜索框中搜索资料的名称。如果资料为其它资料的另外一个版本(比如铀单元是单铀棒的另外版本)，填写另外版本之后会在**填写的资料**(不是正在编辑的资料)页面显示当前物品的资料。 74 | -------------------------------------------------------------------------------- /docs/editor.md: -------------------------------------------------------------------------------- 1 | # 编辑器使用教程与准则 2 | 3 | ## 使用教程 4 | 5 | ### 编辑器类型 6 | 目前百科只允许使用富文本编辑器，Markdown待定。 7 | 8 | 编辑器有两种类型：富文本和Markdown，可在个人中心的论坛设置选项卡内更换(或者点击[这里](http://bbs.mcmod.cn/home.php?mod=spacecp&ac=profile&op=info))： 9 | 10 | ![2](https://cloud.githubusercontent.com/assets/5229241/14761416/6a0b0eac-0993-11e6-9bb5-d46a11a04de3.jpg) 11 | 12 | #### 富文本 13 | 14 | ![3](https://cloud.githubusercontent.com/assets/5229241/14761414/681670be-0993-11e6-9689-89bd41e13b2e.jpg) 15 | 16 | 富文本编辑器的格式选项都在编辑器上方的功能条内，鼠标悬浮在选项上方即可查看对应的功能。 17 | 18 | #### Markdown 19 | 20 | ![4](https://cloud.githubusercontent.com/assets/5229241/14761415/68ffb4c2-0993-11e6-9fca-8a9cd8f0a02e.jpg) 21 | 22 | 使用Markdown语言进行编辑，如果不了解可以点击[这里](http://younghz.github.io/Markdown/)或者[这里](https://coding.net/help/doc/project/markdown.html)进行学习(前面一篇更适用于新手)。 23 | 24 | ## 用语与排版准则 25 | 26 | ### 用语 27 | 28 | 参见[百科主站编辑规范](https://bbs.mcmod.cn/thread-646-1-1.html)。 29 | 30 | ### 排版 31 | 32 | 待讨论…… 33 | -------------------------------------------------------------------------------- /docs/group.md: -------------------------------------------------------------------------------- 1 | # 编辑小组 2 | 3 | ## MOD相关 4 | 5 | ### 无编辑小组时 6 | 7 | - MOD默认状态为无编辑小组。 8 | - 此状态下，实习编辑员以上且无编辑组成员身份的用户可无审核编辑改MOD。 9 | 10 | ### 有编辑小组时 11 | 12 | - 当产生一个编辑小组成员，则MOD状态转为拥有编辑小组。 13 | - 非该编辑小组成员编辑时，需审核。 14 | - 该编辑小组成员编辑时，无需审核。 15 | - 资料应以编辑小组成员为主，以非编辑小组为辅。 16 | 17 | ## 申请相关 18 | 19 | ### 申请方式 20 | 1. 点击进入[申请相关](http://bbs.mcmod.cn/forum.php?mod=forumdisplay&fid=5)区 21 | 22 | ![area](https://cloud.githubusercontent.com/assets/13271372/16149746/62559404-34c5-11e6-9dbd-3983cf491c7d.png) 23 | 24 | 2. 点击`发表主题` 25 | 26 | 3. 填写表格 27 | 28 | ![table](https://cloud.githubusercontent.com/assets/13271372/16149894/528095fa-34c6-11e6-998d-f4f43b596a1f.png) 29 | 30 | 31 | !!! note 32 | 33 | 申请编辑员时必须指定想要维护的MOD 34 | 35 | ### 申请要求 36 | 37 | - 具有基本资料编辑能力 38 | - 编辑资料数目较多，且编辑质量良好 39 | - 对该MOD有充分的了解 40 | - 未完待续…… 41 | 42 | 43 | -------------------------------------------------------------------------------- /docs/index.md: -------------------------------------------------------------------------------- 1 | MCMOD百科官方文档 2 | ================== 3 | 4 | 这里是MCMOD百科官方文档(WIP) -------------------------------------------------------------------------------- /docs/issues.md: -------------------------------------------------------------------------------- 1 | # 意见反馈区使用教程 2 | 3 | 意见反馈区已迁移至Github，地址为：[https://github.com/Ahrwing/mcmod/issues](https://github.com/Ahrwing/mcmod/issues) 4 | 5 | 本区仅受理[MC百科](https://www.mcmod.cn/)相关的BUG和意见，MC玩法相关提问请转到[论坛](https://bbs.mcmod.cn/)。 6 | 7 | 8 | ## 反馈流程 9 | 10 | 1. 首先请登录或者注册一个**GitHub账号**。 11 | 2. 进入意见反馈区：[https://github.com/Ahrwing/mcmod/issues](https://github.com/Ahrwing/mcmod/issues) 12 | 2. 进入之后你会看到这样的界面： 13 | ![2](https://cloud.githubusercontent.com/assets/5229241/9202512/d50559c0-4084-11e5-82fa-4f31719ca295.png) 14 | 4. 点击右上角的`New Issue`按钮发起新的意见： 15 | ![3](https://cloud.githubusercontent.com/assets/5229241/9202587/28f4cdfe-4085-11e5-94d8-69b4e81fa569.png) 16 | 5. 进入之后你会看到编辑器界面： 17 | ![4](https://cloud.githubusercontent.com/assets/5229241/9203004/2d91fe70-4087-11e5-9b76-c5b7a8363869.png) 18 | 6. 该编辑器使用Markdown语法，如果不了解可以点击[这里](http://younghz.github.io/Markdown/)或者[这里](https://coding.net/help/doc/project/markdown.html)进行学习。 19 | 7. 意见的`Label`普通用户无法编辑，我们看到之后会根据内容添加的。 20 | 8. 大家一起喵帕斯吧！ 21 | -------------------------------------------------------------------------------- /docs/itemrender.md: -------------------------------------------------------------------------------- 1 | # ItemRender使用教程 2 | 3 | ItemRender原作者为[Kobata](https://github.com/Kobata)，MCMOD百科现使用的是专门定制的修改版本。修改版本目前支持1.7.10至1.14.4版本，最主要的新加功能为批量导出json。 4 | 下载请前往：[百科下载](https://www.mcmod.cn/download/1166.html) 5 | 6 | ## 基础功能 7 | 8 | ### 导出方块/物品 9 | 10 | 首先，请进入设置查看导出方块/物品的按键。如下图所示： 11 | 12 | ![block key](https://cloud.githubusercontent.com/assets/5229241/12267820/e92cab28-b984-11e5-8c2b-1f954742bb34.png) 13 | 14 | 默认的按键为 `[` 和 `]`。如果按键冲突了请改为其它的按键。括号后面的数字代表导出图片的分辨率。 15 | 16 | 找到按键之后，请进入游戏，并将你需要渲染的物品拿在手上，分别按下先前查看的按键(默认 `[` 和 `]`)，注意按下之后如果没开Toggle Render游戏内将不会有任何反应，但其实已经完成了。 17 | 18 | 渲染完毕之后，请进入 `.minecraft/rendered/` 文件夹(`.minecraft/` 为游戏目录)，如果没出问题你将会看到渲染出的图片已经保存在文件夹里了。带有 `_grid` 的文件为小图标，默认为32x，无后缀名的为大图标，默认为128x。 19 | 20 | 在添加条目时，图标在拓展信息选项卡内，选择导出的文件上传即可： 21 | 22 | ![upload](https://cloud.githubusercontent.com/assets/5229241/12271426/00452bd0-b996-11e5-86e4-d84137fa7f47.png) 23 | 24 | 如果你发现导出的图片中方块/物品超过图片的大小，请看下面高级功能部分的指令部分。 25 | 26 | >如果安装了Not Enough Items(NEI)，你也可以使用NEI的Item Panel批量导出物品图标。 27 | > 28 | >进入方法为：Options->Tools->Data Dumps->Item Panel->PNG 29 | >如下图： 30 | >![nei](https://cloud.githubusercontent.com/assets/5229241/12268873/aaff74fc-b989-11e5-8517-c47b4eb511dc.png) 31 | > 32 | >点击左边的32x32按钮可以切换分辨率。导出的文件会输出到 `.minecraft/itempanel_icons/` 文件夹。 33 | 34 | ### 导出生物 35 | 36 | 请进入设置查看导出生物的按键。如下图所示： 37 | 38 | ![entity key](https://cloud.githubusercontent.com/assets/5229241/12269034/5af3ccfa-b98a-11e5-8a66-94e3faca35a9.png) 39 | 40 | 默认的按键为 `;` 和 `'`。如果按键冲突了请改为其它的按键。括号后面的数字代表导出图片的分辨率。 41 | 42 | 查看好按键之后，进入游戏，并寻找或生成一只需要渲染的生物。请将鼠标指向生物，并分别按下先前查看的按键(默认 `;` 和 `'`)。按下后游戏内不会有反应，请到 `.minecraft/rendered/` 文件夹内寻找渲染好的文件。带有 `_grid` 的文件为小图标，默认为128x，无后缀名的为大图标，默认为512x。 43 | 44 | 如果你发现导出的图片中生物超过图片的大小，请看下面高级功能部分的指令部分。 45 | 46 | ### 批量导出 47 | 48 | 首先，请保证客户端内的mod数量越少越好，最好只装要导出的mod和ItemRender，否则导出的时间会非常长，甚至导致导出失败。 49 | 50 | 接下来，进入设置查看批量导出的按键。如下图所示： 51 | 52 | ![export key](https://cloud.githubusercontent.com/assets/5229241/12269284/a08db28e-b98b-11e5-9c78-b8ff771b8eed.png) 53 | 54 | 默认的按键为 `I`。如果按键冲突了请改为其它的按键。 55 | 56 | 查看好按键之后，请进入游戏，直接按下刚才查看的按键(默认 `I`)。接下来客户端应该会未响应一会，请不要操作客户端，耐心等待。一旦客户端恢复响应，那么导出就完成了。请到`.minecraft/export/`文件夹中找导出的文件。文件应该类似于下图： 57 | 58 | ![json](https://cloud.githubusercontent.com/assets/5229241/12271450/1a6bf30e-b996-11e5-8cca-6a55dd01c3d3.png) 59 | 60 | 导出的文件以modid.json的形式命名，内容包括mod内所有物品的：中文名，英文名，最大耐久，最大堆叠数量，大图标，小图标(储存为Base64字符串)。**如果你想批量导入物品，请将JSON文件交给编辑员。** 61 | 62 | 嘛，导出后游戏的确会有副作用，比如说语言换了什么的，不用这么在意细节是吧_(:з」∠)_ 63 |
64 |
65 | 注意ItemRender导出的JSON文件和NEI在Item Panel导出的JSON是完全不同的！ 66 | 67 | ItemRender导出的JSON文件为百科定制，只有ItemRender的JSON才能正常导入。 68 | 69 | 而NEI的JSON文件为物品的NBT数据(具体见：[http://www.mcmod.cn/post/189.html](http://www.mcmod.cn/post/189.html))。 70 | 71 | ## 高级功能 72 | 73 | ### 缩放大小 74 | 75 | ItemRender添加了一条指令 `/itemrender scale [value]`以解决物品/生物导出的图标不完整的问题，其中 `[value]` 为缩放因子，范围是0.0-2.0。 76 | 77 | 使用时请进入游戏，并在渲染之前输入指令，比如 `/itemrender scale 0.8`。注意这条指令同时影响生物和方块/物品的渲染大小，并且也会影响批量导出时物品图标的大小。所以在批量导出如无特殊情况请保证缩放因子调为1.0。 78 | 79 | ### 显示上次渲染结果 80 | 81 | 先去按键设置查看Toggle Render的键位，默认为 `O`。如下图： 82 | 83 | ![toggle key](https://cloud.githubusercontent.com/assets/5229241/12271455/2aa72ac2-b996-11e5-9cc0-e3397c30eab7.png) 84 | 85 | 使用时请进入游戏，在渲染过方块/物品之后按下按键(默认 `O`)，你会在游戏窗口左上角看到上一次渲染的方块/物品，再次按下按键则关闭显示。显示效果如下图： 86 | 87 | ![toggle](https://cloud.githubusercontent.com/assets/5229241/12271464/375f0c80-b996-11e5-91e5-8eff3287419e.png) 88 | 89 | ### 导出黑名单 90 | 91 | 由于mod中有些物品导出时会导致崩溃(比如说神秘5的某一个Research Note)，ItemRender添加了导出黑名单功能。如果想要启用，请在主菜单中点击Mods->ItemRender->Config->BlackList。 92 | 93 | 点击加号添加条目，条目的格式为 `unlocalizedName@metadata`。如果你不知道条目该怎么写，把DebugMode打开，崩溃了之后看log(客户端的)，最后正在处理的那个就是出问题的物品。 94 | 95 | ### 导出玩家 96 | 97 | 这个功能和导出生物一样，不过导出的对象是玩家自己。按键设置里查看按键，默认为 `P`： 98 | 99 | ![player key](https://cloud.githubusercontent.com/assets/5229241/12271475/471bdca2-b996-11e5-9085-73286ba7d6a6.png) 100 | 101 | 进入游戏，按下按键(默认 `P`)，渲染之后请到 `.minecraft/rendered/` 文件夹内寻找 `player.png`。 102 | 103 | ## 设置 104 | 105 | 设置的所有内容都可以在游戏内修改，游戏内设置进入方法为Mods->ItemRender->Config。 106 | 107 | - **BlackList**：导出黑名单，推荐在游戏内设置 108 | - **DebugMode**：调试模式，主要是为了判断导出出错的物品用的 109 | - **ExportVanillaItems**：是否导出原版物品，原版物品在导出时会占用很长时间，如果不需要导出原版物品的话请设置为false 110 | - **RenderBlockGrid**：方块/物品渲染小图标分辨率 111 | - **RenderBlockMain**：方块/物品渲染大图标分辨率 112 | - **RenderEntityGrid**：生物渲染小图标分辨率 113 | - **RenderEntityMain**：生物渲染大图标分辨率 114 | - **RenderPlayer**：玩家渲染分辨率 115 | 116 | ## 错误 117 | 118 | 如果在游戏中按键无反应，且在修改按键界面看到 `OpenGL Error` 的提示，那说明你的电脑不支持OpenGL 3.2及以上版本，请考虑升级显卡驱动或者更换显卡。 119 | -------------------------------------------------------------------------------- /docs/log.md: -------------------------------------------------------------------------------- 1 | # 日志添加/编辑教程 2 | 3 | ## 进入添加日志页面 4 | 5 | 要想进入添加日志的页面，请点击模组页面右侧的 `新建日志` 按钮： 6 | 7 | ![link](https://i.mcmod.cn/editor/upload/20200803/1596419348_7254_pGRU.png) 8 | 9 | 除此之外，在日志列表中也有能新建日志的地方。 10 | 11 | ## 基本信息 12 | 13 | - **正文**：在这里填写日志的更新内容，一般都能从Mod的官方网站中找到，可以不用翻译。如果要写中文的话请尽量自己逐条翻译，不要用其他人的翻译，因为其他人的翻译可能不准确，比如中文的Minecraft wiki的翻译就存在很大的遗漏。**严禁不加处理的机翻。** 具体使用方法请查看[编辑器使用教程与准则](http://help.qwq.fun/1835006)。点击编辑器上方的 `正文预览` 可以预览编辑结果。 14 | - **更新日期**：日志对应的版本更新时间，按官方时间更改，无需考虑时差。 15 | - **Mod版本号**：日志对应的版本名称，需与官方的版本对应。 16 | - **MC版本**：日志更新的对应支持MC版本，相当于给日志分类，相同的版本会合并显示。 17 | 18 | ## 注意事项 19 | 20 | - 日志非编辑员无法排序，如果想要排序请找编辑员。 21 | - 日志非资深编辑员无法删除，如需删除请在[此处](https://bbs.mcmod.cn/forum.php?mod=viewthread&tid=341&extra=)发帖申请。 22 | -------------------------------------------------------------------------------- /docs/mod.md: -------------------------------------------------------------------------------- 1 | # 模组添加/编辑教程 2 | 3 | ## 进入添加模组页面 4 | 5 | 要想进入添加模组的页面，请点击首页右方的 `添加模组` 按钮： 6 | 7 | ![link](https://cloud.githubusercontent.com/assets/5229241/12357573/7ad0f2f4-bbe3-11e5-89d8-ebb17ffb3192.png) 8 | 9 | 或者，直接点击[这里](http://www.mcmod.cn/class/add)进入添加模组界面。 10 | 11 | ## 进入编辑模组页面 12 | 13 | 要想进入编辑模组的页面，请先进入要修改的模组页面之后点击左侧的 `编辑模组` 按钮： 14 | 15 | ![edit](https://user-images.githubusercontent.com/20513115/43036581-f9d968e8-8d36-11e8-97a7-d7341e4dc975.png) 16 | 17 | 18 | ## 基本信息 19 | 20 | - **编辑器**：这里为Mod的简介，请在这里描述Mod的基本功能与主题，或者对于一些简单的功能性Mod来说可以描述Mod的用法。但请注意描述不要过于简单，一般情况下最好不要低于30个字。具体使用方法请查看[编辑器使用教程与准则](http://help.qwq.fun/1835006)。点击 `提交修改` 边上的 `预览内容` 可以预览编辑的结果。 21 | - **MOD名称**：这里一般为Mod的中文译名，但在无译名或译名不通用的情况下可以直接填写Mod的原名(比如说 `Not Enough Items`)。此项为必填项。 22 | - **MOD原名**：这里为Mod的原名，一般为英文。在 `MOD名称` 已填写原名的情况下这一项可以空着不填。此项为选填项，但除了 `MOD名称` 填写的是原名的情况以外，请务必认真填写，否则审核的时候会无法断定Mod的有效性与重复性，并且用户寻找Mod时也会遇到困难。 23 | - **简写名称**：这里为Mod的简写名称，比如说 `Not Enough Items` 简写为 `NEI`，`BuildCraft` 简写为 `BC`。在显示的时候会在方括号内注在Mod前方，比如说 `[BC]建筑 (BuildCraft)`。要注意的是，如果一个Mod没有常用的简写名称(很少被国内外社区用到过)，请不要填写，并且不要随便按照个人喜好随便缩写，此项为选填项。 24 | - **所属分类**：这里为Mod的分类。环境类Mod一般添加了新的Biome，建筑，或者维度(比如Twilight Forest)。生物类Mod主题为更多的动物或怪物(比如Grimoire of Gaia 3)。综合类mod一般有自己的系统与特色，科技或魔法Mod属于这一分类(比如Thaumcraft 5)。补丁类Mod包括无关游戏性的修改，一般起辅助作用(比如Not Enough Items)。注意选择分类时请选择Mod的最显著特征，比如说即使可能Biomes O' Plenty添加了生物，其更显著特点为添加了Biome，所以应该分为环境类。 25 | - **支持MC版本**：这里是Mod支持的MC版本，根据官方资料，在支持的MC版本复选框中打钩。 26 | - **模组关系**：这里可以添加与所编辑Mod有前置、拓展或联动关系的Mod。前置指此模组必须依靠这些前置模组才能启动游戏；拓展指这些模组向此模组追加了一些东西，可有可无且无法独立运行；联动指两个模组之间皆可独立存在并启动游戏，可以互相完成一些微小的工作。 27 | - **模组元素**：这里可以选择与Mod有关的元素。核心元素一般只选择一种，其他元素视Mod本身功能酌情选择。 28 | 29 | ## 拓展信息 30 | 31 | - **模式**：Mod的联机模式，一般情况下为 `SSP/SMP`，及单人与多人皆可。`SSP` 为仅单人模式。`SMP` 为仅多人模式。 32 | - **封面**：这里填的是封面的地址，**请尽量使用百科站内的地址**。封面分辨率为240x150，如果分辨率不对的话百科会自动进行拉伸。封面上传方式见下面的Note。此项为选填项，但为了美观请最好添加。 33 | - **模组标签**：这里填写模组的标签，一般填写Mod中重点或有特色的内容。标签相当于 `MOD分类` 之下的再一次划分，比如可以填写 `科技`，`电力`，`自动化` 之类的词语，每个标签输入完之后按下回车，代表各个标签的结束。这一项为选填项。 34 | 35 | ### 封面上传 36 | 37 | 首先在编辑器中点击图片按钮： 38 | 39 | ![pic1](https://cloud.githubusercontent.com/assets/5229241/12359534/c99095d4-bbed-11e5-91ce-12135f8c54fd.png) 40 | 41 | 选择 `本地上传` 选项卡，并点击 `添加照片`，选择并上传。等图片显示在编辑器中，单击刚上传的图片，并再次点击图片按钮(如果图片按钮被挡住请用滚轮调节位置再点击)。这次在 `远程图片` 选项卡中就会出现图片的地址了： 42 | 43 | ![pic2](https://cloud.githubusercontent.com/assets/5229241/12359674/b5c90b0c-bbee-11e5-8a95-c3c76ce2c95d.png) 44 | 45 | 复制图片的地址，并粘贴到封面项目中。 46 | 47 | ## 官方信息 48 | 49 | - **官方状态**：这一项表示目前Mod的官方动向，**切勿不考据乱填**。 50 | - **作者/团队**：这一项为Mod作者或团队的名称。如果是在GitHub上多人贡献的Mod，请填主要贡献人或者是发布者。为非必填项。 51 | - **相关链接**：这一项为与mod有关的链接，一般为Minecraft Forum、CurseForge、Github、Mcbbs的地址，当然也可能是作者自己的网站(官网)。非必填项，但强烈建议填写以便核对与下载Mod。 52 | -------------------------------------------------------------------------------- /docs/recipe.md: -------------------------------------------------------------------------------- 1 | # 合成表添加/编辑教程 2 | 3 | ## 进入添加合成表页面 4 | 5 | 要想进入添加合成表的页面，请先打开要编辑的物品页面，点击标题右方的 `加合成表` 按钮： 6 | 7 | ![add](https://cloud.githubusercontent.com/assets/5229241/12781412/30d45bd4-caaf-11e5-853d-3264cef7be4f.png) 8 | 9 | ## 进入编辑合成表页面 10 | 11 | 要想进入编辑模组的页面，请先打开要编辑的物品页面，并找到要修改的合成表，鼠标移动到右侧的小箭头并选择 `编辑合成表` 按钮： 12 | 13 | ![edit](https://cloud.githubusercontent.com/assets/5229241/12781509/d2594442-caaf-11e5-9b47-21465487c6b6.png) 14 | 15 | ## 删除合成表 16 | 17 | 如果要删除合成表，请先打开要编辑的物品页面，并找到要删除的合成表，鼠标移动到右侧的小箭头并选择 `申请删除` 按钮： 18 | 19 | ![delete](https://cloud.githubusercontent.com/assets/5229241/12781557/0e17e646-cab0-11e5-9ac3-4a976a93386c.png) 20 | 21 | 点击之后将会跳转到一个页面填写理由。 22 | 23 | 注意不要因为一个合成表在mod内移除了就删除合成表，这种情况下请编辑合成表并添加版本说明。 24 | 25 | ## 基本信息 26 | 27 | 这里指的是添加和编辑时的基本信息。 28 | 29 | - **物品选择框**：就是有一堆物品那个，点击这里的物品之后将可以在下方合成表对应格处显示。最多显示108个物品。 30 | - **物品来源**：指的是上面物品选择框内的物品所属模组，比如说想要查找工业2模组里的物品，`物品来源` 选择工业2就行了。这一项并不影响合成表的最终结果。 31 | - **筛选模组**：对 `物品来源` 内的模组进行过滤，输入之后 `物品来源` 将只显示匹配的模组。这一项并不影响合成表的最终结果。 32 | - **查找物品**：对 `物品选择框` 进行过滤，输入后 `物品选择框` 将只显示名字与该项一样的物品。这一项并不影响合成表的最终结果。 33 | - **合成表**：编辑合成表的地方，具体使用见下： 34 | 35 | ![crafting](https://cloud.githubusercontent.com/assets/5229241/12782372/db840646-cab5-11e5-8a08-813714295c64.png) 36 | 37 | ![crafting](https://cloud.githubusercontent.com/assets/5229241/12782725/13329b0a-cab8-11e5-93b9-19fda91babd2.png) 38 | 39 | 左侧下拉框为选择合成表类型，点击下拉选项框可以选择其他mod里的合成表。如果没找到想要的合成表类型可以找编辑员添加。 40 | 41 | `清空所有` 选项可将右侧合成表内所有输入全部清空。`消除选中` 选项可消除合成表内当前选中的物品(用 `[...]` 标识)。 42 | 43 | 点击合成表上带颜色点的框可以选中，选中之后点击上方 `物品选择框` 内的物品即可在对应格子放置该物品。 44 | 45 | 下方的文本框为材料/成品的数量，默认当前编辑物品为第1格成品。每一项中 `材料` 与 `成品` 字体的颜色对应合成表中点的颜色，在每一个文本框中填写对应格子的需求数量即可。 46 | 47 | ## 拓展信息 48 | 49 | - **摆放要求**：即合成表为有序或无序合成。 50 | - **有序**：即Shaped Recipe，要想合成出来该物品，材料必须要按照合成表中的顺序进行摆放，例如原版中信标的合成。 51 | - **无序**：即Shapeless Recipe，材料的摆放位置不影响最终合成出来的结果。例如原版中蘑菇煲的合成。 52 | - **模组要求**：合成表出现所需的模组，比如说某些模组会加原版物品的新合成表，这时候就需要在这里选中该模组。如果是某模组本身的合成表，则不需要选择。 53 | - **开始版本**：合成表首次添加的版本，默认为首发版本。 54 | - **结束版本**：合成表最后一次移除的版本，默认为至今。 55 | - **备注**：这里可以写一些合成表的注意事项，比如说某些物品可以用其它物品替换之类的。 56 | -------------------------------------------------------------------------------- /docs/styleguide.md: -------------------------------------------------------------------------------- 1 | # 资料编写指南 2 | 3 | 此指南仅作为给编辑者一个大致的指导，在尽量保证编辑自由度的同时提供一个可能的标准。 4 | 不同mod可以根据各自的特性而对此指南里的建议进行适当的改动。 5 | 6 | **目前该帮助文档正在更新v4内容——** 7 | 8 | ## 基本准则 9 | 10 | - 对一些事情不确定时，找百科编辑员帮忙，或者在评论区发言； 11 | 12 | - 不要添加冗余信息，如果资料过期失效，试着更新它； 13 | 14 | - 保持中立的观点和语气，这样有助于保持百科的水准； 15 | 16 | - 编辑条目时请尽可能保证内容简明、精确、符合事实； 17 | 18 | - 强烈推荐原创内容，允许少量引用外来内容，但是必须得到原作者许可，并附注来源； 19 | 20 | - 不要发表垃圾信息，广告，攻击性言论，违者将被关入小黑屋。 21 | 22 | ## 关于物品分类 23 | 24 | 物品分类可以分为包括但不限于以下几个项目： 25 | 26 | - 装饰品：主要用于装饰，同样可以用于组成建筑的主要部分，其主要功能在于“提供外观”。 27 | 28 | - 资源：由世界自然生成的并可以以一定方法加以利用的物品，如矿石，杀死生物掉落的物品，花卉等。 29 | 30 | - 材料：采集资源后经过加工而得到的物品，如木棍，纸，铁锭等物品，这样的物品一般情况下均用于进行更进一步的合成。 31 | 32 | - 工具：一般情况下必须手持才能使用的物品，如稿，斧头，扳手等，这类物品一般均具有耐久度，且物品不能叠加。 33 | 34 | - 装备：穿在身上或仅仅携带即可发挥作用的物品，如护甲，mod添加的饰品等（如神秘时代4里面的戒指，护身符，奥法缰绳等），大多数情况下也具有耐久度。 35 | 36 | - 武器：用于对其他生物造成伤害，其他特性与“工具”类似。 37 | 38 | - 机器： 39 | 1. 可放置于世界中 40 | 2. 具备一定的功能（冶炼矿物，转化物品，制造或收集资源用于加工等） 41 | 3. 一般情况下需要以某种形式供能 42 | 43 | ## 关于耐久度 44 | 45 | 以下分类一般情况下需要考虑耐久度编辑问题： 46 | 47 | - 工具 48 | 49 | - 装备 50 | 51 | - 武器 52 | 53 | - 其他特定项目，如工业时代2里面的[转子](https://www.mcmod.cn/item/8505.html) 54 | 55 | ## 关于条目编辑 56 | 57 | 一个“完备”的条目`正文部分`应当具备以下的内容： 58 | 59 | 1. 物品/方块的功能，用法 60 | 61 | 2. （若包含）物品/方块的耗能，产能或类似属性 62 | 63 | 3. （若包含）物品/方块的gui与其各部分作用描述 64 | 65 | 4. （若包含）注意事项。如物品使用时的附属效果（buff、debuff及持续时间）或者简要建议（如提高使用效率的方法）等等 66 | -------------------------------------------------------------------------------- /docs/user.md: -------------------------------------------------------------------------------- 1 | # 用户相关 2 | 3 | ## 用户组 4 | 5 | 用户组一共有6个(实际上你只能见到4个/w\\)，分别为： 6 | 7 | - **百科用户** 8 | - **百科编辑员** 9 | - **资深编辑员** 10 | - **禁止编辑** 11 | - **禁止发言** 12 | - **禁止访问** 13 | 14 | 新用户在注册的时候默认会变为**百科用户**，注册请点击[这里](http://www.mcmod.cn/reg)。 15 | 编辑员可通过申请获得，如果想要申请请进入百科论坛，在“[申请相关](https://bbs.mcmod.cn/forum.php?mod=forumdisplay&fid=51)”版块申请。 16 | 目前用户组正在修缮当中。 17 | 18 | ## 权限 19 | 20 | | | 百科用户 | 百科编辑员 | 资深编辑员 | 禁止编辑 | 禁止发言 | 禁止访问 | 21 | | -------- | ------- | --------- | -------- | ------- | ------- | ------- | 22 | | 一般访问 | √ | √ | √ | √ | √ | × | 23 | | 一般编辑 | √ | √ | √ | × | √ | × | 24 | | 发表短评 | √ | √ | √ | √ | × | × | 25 | | 免审核编辑| × | √ | √ | × | × | × | 26 | | 进入后台 | × | √ | √ | × | × | × | 27 | | 后台审核 | × | × | √ | × | × | × | 28 | | 删除条目 | × | × | √ | × | × | × | 29 | | 验证码长度| 2 | 0 | 0 | 6 | 6 | 6 | 30 | 31 | ## 个人信息 32 | 33 | 个人信息可以在论坛个人中心进行修改。通过点击任意页面右上角的头像进入个人中心，再点击顶部右下角的`前往论坛个人中心`进入。 34 | 35 | ### 修改信息 36 | 37 | 修改信息按钮在论坛个人中心上方，如图所示： 38 | 39 | ![basic](https://i.mcmod.cn/editor/upload/20200801/1596285121_7254_PiPV.png) 40 | 41 | 可修改的项目有： 42 | 43 | - **个人信息**： 44 | - **MCID**：在Minecraft服务器中常使用的名字。 45 | - **性别**：分为保密、男、女。 46 | - **生日**：透露下自己的破壳日。 47 | - **出生地/居住地**：自己的出生/居住所在地。 48 | - **血型**：想想自己红细胞的型号。 49 | - **常驻服务器**：这里可以填经常玩的服务器IP。 50 | - **自我介绍**：简单介绍下自己吧。 51 | - **口癖0v0**：喵呜机！！！ 52 | - **兴趣爱好**：每个人都有自己的爱好。 53 | - **真实姓名**：不便透露。 54 | 55 | - **通用设置**： 56 | - **个人中心背景**：个人中心主页的背景，这里填的是图片的地址，图片请尽量选能重复拼接的，因为背景的repeat是打开的。图片上传见下note。 57 | - **背景样式**：分为平铺、横向平铺、拉伸与居中四种样式，平铺为默认样式。 58 | - **自定义头衔**：显示于个人签名上方。 59 | - **个人签名**：显示于个人中心与帖子末尾。 60 | - **时区**：设置当地时区。 61 | 62 | - **联系方式**：分为QQ、SteamID、战网、手机四项可更改项目，请视情况填写。 63 | 64 | ### 论坛相册图片上传 65 | 66 | 首先，将鼠标移至自己的用户名上，出现下框。 67 | 68 | 然后点击“我的相册”，进入论坛相册页面。 69 | 70 | ![image](https://cloud.githubusercontent.com/assets/20513115/25803961/1c1ba32c-342c-11e7-9d9e-e855af09c8c8.png) 71 | 72 | 点击右上角的“上传图片”，进入图片上传页。 73 | 74 | ![image](https://cloud.githubusercontent.com/assets/20513115/25805102/fc3add48-3430-11e7-80d3-01f8022f2541.png) 75 | 76 | 点击“选择文件上传”，选择电脑中的图片进行上传。(若无此按钮，请检查Flash是否配置正常) 77 | 78 | 在下方选择图片存储的相册，最后 **需点击“开始上传”** 图片才能成功保存到相册里。 79 | 80 | 图片上传成功后会自动跳转到相册页，点击上传的那张图片，进入图片详情页，**复制图片下方的“此图片地址”**。 81 | 82 | ![image](https://cloud.githubusercontent.com/assets/20513115/25805750/687e36a6-3433-11e7-9858-7346750b1967.png) 83 | 84 | 该链接即为图片链接，可用于百科及站外服务。 85 | 86 | 87 | ### 修改头像 88 | 89 | 依照图示进入头像设置界面： 90 | 91 | ![image](https://i.mcmod.cn/editor/upload/20200801/1596288669_7254_JcJO.png) 92 | 93 | 进入之后选择一张合适的图片并点击`上传`。注意头像是可以裁剪的，所以图片并不一定需要是方形。 94 | 95 | 上传之后裁剪为合适的大小，再点击`更新`就修改成功了。 96 | -------------------------------------------------------------------------------- /mkdocs.yml: -------------------------------------------------------------------------------- 1 | pages: 2 | - 主页: 'index.md' 3 | - 资料编写指南: 'styleguide.md' 4 | - 用户组: 'user.md' 5 | - 维护小组: 'group.md' 6 | - 意见反馈区使用教程: 'issues.md' 7 | - ItemRender使用教程: 'itemrender.md' 8 | - 模组添加/编辑教程: 'mod.md' 9 | - 资料添加/编辑教程: 'data.md' 10 | - 合成表添加/编辑教程: 'recipe.md' 11 | - 日志添加/编辑教程: 'log.md' 12 | - 编辑器使用教程与准则: 'editor.md' 13 | - 后台使用教程: 'admin.md' 14 | 15 | site_name: MCMOD百科官方文档 16 | 17 | markdown_extensions: 18 | - admonition 19 | - smarty 20 | - sane_lists 21 | 22 | theme: readthedocs 23 | 24 | extra_css: 25 | - css/code.css 26 | --------------------------------------------------------------------------------