更新 TODO 文件

Merge pull request !4 from ElapsingDreams/N/A
非常好的偏移表

.gitattributes

@@ -0,0 +1,3 @@
+*.yaml linguist-language=Python
+*.xml linguist-language=Python
+*.md linguist-language=Python

.gitignore

@@ -0,0 +1,175 @@
+# sth. can't open
+/msctPkgver/secrets/*.py
+/msctPkgver/secrets/*.c
+/fool/
+
+# mystuff
+/*.zip
+/.vscode
+/*.mid
+/*.midi
+/*.mcpack
+/*.bdx
+/*.msq
+/*.fsq
+/*.json
+/*.mcstructure
+.mscbackup
+/logs
+/languages
+/llc_cli.py
+/utils
+test.py
+RES.txt
+/MSCT_Packer.py
+/Packer/*.MPK
+/Packer/checksum.txt
+/bgArrayLib
+/fcwslib
+test_lyric-mido.py
+
+# Byte-compiled / optimized
+__pycache__/
+*.pyc
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.pdm-build/
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Pycharm
+/.idea
+
+# log
+/.log
+
+# package
+.7z

.idea/.gitignore

@@ -1,3 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml

.idea/Musicreater.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="PYTHON_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-  <component name="PyDocumentationSettings">
-    <option name="format" value="PLAIN" />
-    <option name="myDocStringFormat" value="Plain" />
-  </component>
-</module>

.idea/inspectionProfiles/Project_Default.xml

@@ -1,46 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="LongLine" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyArgumentEqualDefaultInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyAugmentAssignmentInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyClassicStyleClassInspection" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyCompatibilityInspection" enabled="false" level="WARNING" enabled_by_default="false">
-      <option name="ourVersions">
-        <value>
-          <list size="1">
-            <item index="0" class="java.lang.String" itemvalue="3.10" />
-          </list>
-        </value>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyMandatoryEncodingInspection" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyMissingTypeHintsInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyPep8Inspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="ignoredErrors">
-        <list>
-          <option value="E501" />
-        </list>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyPep8NamingInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="ignoredErrors">
-        <list>
-          <option value="N802" />
-          <option value="N803" />
-          <option value="N806" />
-          <option value="N813" />
-          <option value="N801" />
-        </list>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyUnresolvedReferencesInspection" enabled="true" level="WARNING" enabled_by_default="true">
-      <option name="ignoredIdentifiers">
-        <list>
-          <option value="list.__getitem__" />
-          <option value="list.split" />
-        </list>
-      </option>
-    </inspection_tool>
-  </profile>
-</component>

.idea/inspectionProfiles/profiles_settings.xml

@@ -1,6 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <settings>
-    <option name="USE_PROJECT_PROFILE" value="false" />
-    <version value="1.0" />
-  </settings>
-</component>

.idea/misc.xml

@@ -1,4 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.9" project-jdk-type="Python SDK" />
-</project>

.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/Musicreater.iml" filepath="$PROJECT_DIR$/.idea/Musicreater.iml" />
-    </modules>
-  </component>
-</project>

.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>

.python-version

@@ -0,0 +1 @@
+3.10

LICENSE

@@ -1,192 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works within the Source form or
-          documentation, if provided along with the Derivative Works or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-
-   Copyright 2022 Eilles Wan (金羿)
-
-   Licensed under the Apache License, Version 2.0 (the "License")
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-

LICENSE.md

@@ -0,0 +1,123 @@
+# 汉钰律许可协议，第一版
+
+**总第一版 第二次修订 · 二〇二四年七月七日编 二〇二五年四月二十六日修订**
+
+## 一、重要须知
+
+1.  为保护采用本协议的作品在开源过程中，其著作权人所应有的权益，根据**中华人民共和国著作权法和相关法律法规**，制定本协议。
+
+2.  本协议履行过程中，请注意本协议中**免除或限制**民事主体**责任或权利**的条款、法律适用和争议解决条款（尤其是加有特殊标记的条款），这些条款应在中国法律所允许的范围内最大程度地适用。
+
+3.  若本协议所涉及的自然人**未满 18 周岁**，该自然人应在监护人的陪同下阅读本协议及有关本协议的条款内容，并在取得其监护人同意后开始或继续应用本协议所授权的行为。
+
+4.  由于互联网服务、互联网内容的特殊性，若本协议以电子协议形式分发并签订，其依然有效。您一旦开始对本协议所授权之作品进行本协议所授权的行为，即视为您已经阅读、理解并同意并已经接受本协议的全部条款。
+
+5.  本协议的订立、履行、解释及争议的解决均**适用中华人民共和国法律并排除其他一切冲突法的适用**。_本协议订立于许可证最初的颁发者的地址。若颁发者为自然人，则订立于该自然人户籍所在地；若为法人或非法人组织，则订立于其注册地_。本协议的订立各方应友好协商解决于协议所规定之行为的履行相关的争议；如协商不成，任何一方均可向合同签订地有管辖权的人民法院提起诉讼。
+
+6.  本协议的原本仅为现代汉语，书写于简体中文。若存在其他语言的翻译或其他同等语言但非简体中文文本的版本，应当无法律效力。
+
+## 二、术语定义
+
+1.  “**许可证**”、“**协议**”（后文称“本协议”）是指根据本文档中所列举的全部术语、定义、条款、限制等文本，是本合同的简称称谓。本合同全称是 **“汉钰律许可协议，第一版”**。
+
+2.  “**协议颁发者**”（后文称“颁发者”）是将条款或协议应用于其拥有著作财产权的作品的民事主体，或由其指定从而拥有颁发者身份的民事主体。
+
+3.  “**源**”形式是指对包括但不限于 软件、硬件、文档、配置项 等种类的作品进行修改、编辑的首选形式；若不存在首选形式，则初次编辑该作品所需的形式即为源形式。
+
+4.  “**目标**”形式是指对源形式进行机械转换、翻译、打印、制造、加工等同类型活动后形成的结果形式，包括但不限于源代码编译后的目标软件、生成的文件、转换出的媒体、制造出的机械、打印出的实体文本、加工后的零件。
+
+5.  “**采用本协议的作品**”（后文称“此作品”）是指经颁发者授权而使用本协议进行授权的任何作品，该作品应在自然人可见处明确附加一个自然人可读的版权通知（可以参考文末附录中提供的示例）；若在一个可分割的作品中，部分地采用本协议进行授权，则该部分应当视为一个独立的采用本协议的作品，该作品应当在自然人可见处明确附加一个自然人可读的范围限定和版权通知（同样可以参考文末附录中提供的示例）。
+
+6.  “**贡献**”是指对作品进行的，意在提交给此作品颁发者以让著作权人包含在其作品中的任何修订或补充，该修订或补充同样属于一种作品。依据此定义，**“提交”**一词表示经由此作品颁发者所指定的形式，将其所进行的修改发送给此作品颁发者。该形式应当包括在此作品颁发者指定的平台内发送易于编辑的修改信息、在此作品颁发者指定的电子邮箱中发送易于编辑的修改信息、在此作品颁发者指定的源码控制系统或发布跟踪系统上提交的易于编辑的修改信息，但由著作权人以明显标注或指定为“非贡献”的活动除外。颁发者自己对作品进行的修改同样视作对作品的贡献。
+
+7.  “**贡献者**”是指此作品颁发者接受的贡献的提交者，或包含在作品的贡献清单中的民事主体。贡献者在提交贡献并经此作品颁发者通过且该贡献已经被应用于此作品中后，该贡献者应当视为此作品的著作权人之一，但不应视为此作品非其贡献的部分的著作权人。一个作品的颁发者同样属于其贡献者。**请注意**，针对贡献者提交的贡献，该贡献者应被视为该贡献的协议颁发者，但不应视作本作品的颁发者。
+
+8.  “**用户**”、“**使用者**”是指行使本协议所授权之行为的民事主体。据此，贡献者亦属于用户。
+
+9.  “**商业性使用**”、“**商用**”是指任何以谋取利益为目的的使用，包括但不限于以贩卖、出租的形式对作品进行使用；但若将该获取利益之活动明确指示为“捐赠”，且在获利者在进行本协议所授权的活动时不以捐赠数额为标准而区别之，则此种的获取利益的“捐赠”行为不属于商业性使用。
+
+## 三、权利授予
+
+1.  任何由颁发者所进行的特殊声明、特别注意等此类内容，应当在法律效力上高于本协议的条款或声明；这些声明若与本协议冲突，本协议的该冲突部分无效；本协议与这些声明共同构成颁发者与用户之间的合同。
+
+2.  此作品的贡献者享有其贡献的完整著作权。
+
+3.  此作品的贡献者将自己的贡献的全部著作财产权，免费、公开、不可撤销、无限期、非专有地授予此作品的全部著作权人，并准许其在全世界范围内使用上述权利；若无明确的标识，贡献者允许此作品的颁发者对其贡献进行免费、公开、不可撤销、无限期、非专有、世界范围内的商业性使用。
+
+4.  此作品的著作权人及贡献者授予用户**免费、公开、不可撤销、非专有、非商用**地以任意形式**复制、发行、展览、表演、放映、广播、信息网络传播、摄制、改编、翻译、汇编、二次授权**的权利，准许其在此作品颁发者所指定的区域与时间内行使上述权利；若此作品颁发者未特别指定的，则视作在全世界范围内无限期地授权；若此作品颁发者特别指定在特定情况下可以商用，则应当按照其所指定的条件进行商业性使用，商用的过程中，应当明确标识此作品的著作权人。
+
+5.  一旦此作品有任意由非贡献形式而产生的更改，更改的部分将不视为此作品的一部分，除非该部分不可离开此作品单独存在；若该部分必须依赖此作品而不可与此作品分离从而单独存在，则更改后的作品不视作此作品，在这种情况下，除非此更改后的作品已获得此作品颁发者的特殊许可、或更改者即为此作品颁发者本人，否则对该作品进行的任何活动都应当遵守本协议。
+
+6.  经贡献而产生的对此作品的更改，属于此作品的一部分；在此情况下，更改后的作品，依旧视作此作品。
+
+7.  依据本款的第 4 条，若用户在本协议的授权下，将此作品授予他人进行任何形式的活动（即“二次授权”、“二次分发”），则应确保其使用的协议或授权内容，与本协议的条款不冲突；当存在与本协议条款的冲突时，则该冲突内容无效，被授权的第三方应依照本协议的条款进行活动；除非该用户获得了此作品颁发者的特殊许可、或该用户即为此作品颁发者本人。
+
+8.  依据本款的第 5 条，若由非贡献形式而产生更改的部分是可分割而不需依赖此作品即可单独存在的，若该部分明确注明不使用本协议进行授权或明确声明了其他授权条款，则该部分不视作采用本协议；但未更改的部分仍应视作原此作品的一部分，需要采用本协议进行授权，除非此更改后的作品已获得此作品颁发者的特殊许可、或更改者即为此作品颁发者本人。
+
+9.  若此作品或所提交的贡献包含其著作权人的专利，则该专利所有人即此作品的著作权人应准许此作品全体著作权人**免费、公开、不可撤销、非专有、无版权费的专利许可**，以便贡献者对作品进行本协议所授权进行的活动。
+
+10. 上述专利许可的授予，仅适用于在所提交的贡献中，可由专利所有者授予的，且在对此作品进行本协议所授权的活动中，必须使用的专利。
+
+11. 如果用户对任何民事主体，因其在进行本协议所授权进行的活动中侵犯该用户的专利而提起诉讼，那么根据本协议授予该用户的所有关于此作品的任何其他专利许可将在提起上述诉讼之日起终止。
+
+12. 如果本作品作为用户的其他作品的不可分割的一部分进行任何民事活动，本协议依旧对本作品（即该用户的其他作品的一部分）生效；若本作品完全融入该用户的其他作品之中而不可独立存在，则该用户需要保证其作品存在与本协议冲突的条款；除非该作品已获得此作品颁发者的特殊许可、或该用户即为此作品颁发者本人。
+
+## 四、使用条件
+
+在对此作品进行本协议所授权的民事活动中，应当同时满足以下条款：
+
+1.  用户必须为此作品的任何其他接收者提供本协议的副本，在不得已无法提供副本的情况下，也应明确指示其他接收者可查阅本协议的位置。
+
+2.  用户必须在修改后的作品中附带明显的通知，声明用户已更改文件，并注明更改位置。
+
+3.  若用户二次分发此作品，可以选择向此作品的接收者提供无偿或有偿的担保维修、支持服务或其他责任、义务。但是，该用户只可以其自己的名义提供上述内容，不得以任何其他贡献者的名义。且该用户必须明确表明任何此类责任或义务是由其个人独立提供，且其同意并应当承担赔偿此作品的全体贡献者因其个人承担上述责任义务而产生的任何赔偿责任。
+
+4.  用户不得删除或更改此作品中包含的任何许可声明（包括版权声明，专利声明，免责声明，或赔偿责任限制），除非该更改是对已知事实错误的修补、或其已获得此作品颁发者的特殊许可、或更改者即为此作品颁发者本人。
+
+5.  若此作品将权益的声明通知作为一部分，那么由用户分发的任何版本的作品中须至少在下列三处之一包含该声明通知的自然人可读副本：
+
+    - 该作品的权益声明通知中
+    - 在源形式的文件中（当且仅当该作品开放源代码）
+    - 在惯例中作为第三方通知出现之处（当且仅当该作品会产生画面，且该画面可被自然人详细观察）
+
+    该通知的内容仅供信息提供，不应对许可证进行任何文字上的修改。用户可在其分发的作品中，在不构成修改本协议的前提下，在作品自身的声明通知或属性描述后或作为附录添加。
+
+6.  依据本款第3条，若用户二次分发此作品时，选择向作品的接收者提供收费的担保服务，则必须明确告知该接收者本协议全部内容与此作品原出处，并确保其知悉上述内容；但若用户在二次分发此作品时，不选择提供任何服务，则该用户不允许向作品的接收者收取任何费用，除非该用户获得了此作品颁发者的特殊许可、或该用户即为此作品颁发者本人。
+
+## 五、提交贡献
+
+除非贡献者明确声明，在本作品中由该贡献者向颁发者的提供的提交，必须符合本协议的条款，并与本协议的条款不存在冲突；除非此贡献中与本协议冲突的附加条款已获得颁发者的特殊许可、或贡献者即为此作品颁发者本人。
+
+## 六、商标相关
+
+本协议并未授予用户，将颁发者的商标、专属标记或特定产品名称，用于合理的或惯例性的描述或此类声明之外其他任何位置的权利。
+
+## 七、免责声明
+
+1.  若非因法律要求或经过了特殊准许，此作品在根据本协议“原样”提供的基础上，**不予提供任何形式的担保、任何明示、任何暗示或类似承诺**，此类包括但不限于担保此作品毫无缺陷、担保此作品适于贩卖、担保此作品适于特定目的、担保使用此作品绝不侵权。用户将自行承担因此作品的质量或性能问题而产生的全部风险。若此作品在任何方面欠妥，将由用户（而非任何贡献者、而非任何颁发者）承担所有必要的服务、维修或除错的任何成本。本免责声明是本许可的重要组成部分。当且仅当遵守本免责声明时，本协议的其他条款中对本作品的使用授权方可生效。
+
+2.  无论是因何种原因，如果不是在法律规定的特殊情况（如，确为贡献者的故意或重大过失）下或者经过了特殊准许，即使贡献者事先已知发生损害的可能，在使用本作品时，用户产生的任何直接、间接、特殊、偶然或必然造成的损失（包括但不限于商誉损失、工作延误、计算机系统故障等），**均不由任一贡献者承担**。
+
+**以上是本许可协议的全部条款**
+
+---
+
+附录
+
+**如何在自己的作品中应用 汉钰律许可协议**
+
+若要在自己源形式的作品应用本协议，请在其中附加下面的通知模板，并将六角括号“〔〕”中的字段替换成自身的实际信息来替换（不包括括号本身）。这些文本必须以对应文件格式适当的注释句法包含在其中，可以是实体的纸质文档、也可以是网络公告或者计算机文件；或者脱离该源之外，另起一个新的文件，使之指向要应用本协议的那个作品。同时也建议将作品名或类别名以及目的说明之类的声明囊括在同一个可被打印的页面上作为版权通知的整体，这样更加容易的区分出第三方内容。
+
+若需要在自己以目标形式存在的作品中应用本协议，同样需要附加下面的通知模板并更改六角括号中的字样。但是，这些文本可以是位于作品的标签上、位于作品的用户可见且能被自然人详细观察的画面之中、或者按照惯例中许可协议应该出现的位置；同时，这些文本的所处位置应当能够明确指示到本协议应用的那个作品。另外，建议将作品名或类别名以及目的说明之类的声明囊括在同一个可被打印的位置上作为版权通知的整体，这样更加容易的区分出第三方内容。
+
+**通知模板**
+
+```
+版权所有 © 〔年份〕 〔著作权人〕
+〔或者：版权所有 (C) 〔年份〕 〔著作权人〕〕
+
+〔该作品〕根据 汉钰律许可协议，第一版（“本协议”）授权。
+任何人皆可从以下地址获得本协议副本：〔本协议副本所在地址〕。
+若非因法律要求或经过了特殊准许，此作品在根据本协议“原样”提供的基础上，不予提供任何形式的担保、任何明示、任何暗示或类似承诺。也就是说，用户将自行承担因此作品的质量或性能问题而产生的全部风险。
+详细的准许和限制条款请见原协议文本。
+```

Musicreater/__init__.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+
+"""
+音·创
+是一款免费开源的《我的世界》数字音频支持库。
+
+Musicreater (音·创)
+A free and open-source library for handling with **Minecraft** digital music.
+
+版权所有 © 2026 睿乐组织
+Copyright © 2026 TriM-Organization
+
+音·创（“本项目”）的协议颁发者为 金羿、玉衡Alioth
+The Licensor of Musicreater("this project") is Eilles, YuhengAlioth
+
+本项目根据 第一版 汉钰律许可协议（“本协议”）授权。
+任何人皆可从以下地址获得本协议副本：
+https://gitee.com/TriM-Organization/Musicreater/blob/master/LICENSE.md。
+若非因法律要求或经过了特殊准许，此作品在根据本协议“原样”提供的基础上，
+不予提供任何形式的担保、任何明示、任何暗示或类似承诺。
+也就是说，用户将自行承担因此作品的质量或性能问题而产生的全部风险。
+详细的准许和限制条款请见原协议文本。
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+
+__version__ = "3.0.0-alpha"
+
+__author__ = (
+    ("金羿", "Eilles"),
+    ("玉衡Alioth", "YuhengAlioth"),
+    ("鱼旧梦", "ElapsingDreams"),
+    ("偷吃不是Touch", "Touch"),
+)
+
+from .paramcurve import ParamCurve, InterpolationMethod, BoundaryBehaviour
+
+from .data import (
+    SingleMusic,
+    SingleTrack,
+    SingleNote,
+    SoundAtmos,
+    MineNote,
+    CurvableParam,
+)
+
+from .plugins import load_plugin_module
+
+from .main import MusiCreater
+
+__all__ = [
+    "__version__",
+    "__author__",
+    # 参数曲线相关
+    "ParamCurve",
+    "InterpolationMethod",
+    "BoundaryBehaviour",
+    # 音乐数据结构
+    "SingleMusic",
+    "SingleTrack",
+    "SingleNote",
+    "SoundAtmos",
+    "MineNote",
+    "CurvableParam",
+    # 工程项目相关
+    "load_plugin_module",
+    "MusiCreater",
+]

Musicreater/_plugin_abc.py

@@ -0,0 +1,632 @@
+# -*- coding: utf-8 -*-
+
+"""
+存储 音·创 v3 的插件基类，提供抽象接口以供实际插件使用
+"""
+
+"""
+版权所有 © 2026 金羿
+Copyright © 2026 Eilles
+
+开源相关声明请见 仓库根目录下的 License.md
+Terms & Conditions: License.md in the root directory
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+# =====================
+# NOTE: [WARNING]
+# 这个文件是一坨屎山代码
+# 请勿模仿，请多包容
+# =====================
+
+
+import sys
+
+from abc import ABC, abstractmethod
+from dataclasses import dataclass, field
+from enum import Enum
+from pathlib import Path
+from typing import (
+    Dict,
+    Any,
+    Optional,
+    List,
+    Tuple,
+    Union,
+    Sequence,
+    BinaryIO,
+    Generator,
+    Iterator,
+    Set,
+)
+
+if sys.version_info >= (3, 11):
+    import tomllib
+    import tomli_w
+else:
+    import tomli as tomllib  # 第三方包
+    import tomli_w
+
+from .exceptions import (
+    PluginConfigDumpError,
+    PluginConfigLoadError,
+    PluginMetainfoNotFoundError,
+    PluginMetainfoTypeError,
+    PluginMetainfoValueError,
+    PluginAttributeNotFoundError,
+    ParameterTypeError,
+    PluginInstanceNotFoundError,
+)
+from .data import SingleMusic, SingleTrack
+
+# 已经全部由 plugins.py 提供接口
+# 请用户从 plugins.py 导入
+# 不要在这里导，会坏掉的
+
+# __all__ = [
+#     # 枚举类
+#     "PluginType",
+#     # 抽象基类/数据类（插件参数定义）
+#     "PluginConfig",
+#     "PluginMetaInformation",
+#     # 抽象基类（插件定义）
+#     "MusicInputPlugin",
+#     "TrackInputPlugin",
+#     "MusicOperatePlugin",
+#     "TrackOperatePlugin",
+#     "MusicOutputPlugin",
+#     "TrackOutputPlugin",
+#     "ServicePlugin",
+#     "LibraryPlugin",
+#     # 插件注册用装饰函数
+#     "music_input_plugin",
+#     "track_input_plugin",
+#     "music_operate_plugin",
+#     "track_operate_plugin",
+#     "music_output_plugin",
+#     "track_output_plugin",
+#     "service_plugin",
+#     "library_plugin",
+# ]
+
+
+# ========================
+# 枚举类
+# ========================
+
+class PluginTypes(str, Enum):
+    """插件类型枚举"""
+
+    FUNCTION_MUSIC_IMPORT = "import_music_data"
+    FUNCTION_TRACK_IMPORT = "import_track_data"
+    FUNCTION_MUSIC_OPERATE = "music_data_operating"
+    FUNCTION_TRACK_OPERATE = "track_data_operating"
+    FUNCTION_MUSIC_EXPORT = "export_music_data"
+    FUNCTION_TRACK_EXPORT = "export_track_data"
+    SERVICE = "service"
+    LIBRARY = "library"
+
+
+
+# ========================
+# 数据类
+# ========================
+
+
+@dataclass
+class PluginConfig(ABC):
+    """插件配置基类"""
+
+    def to_dict(self) -> Dict[str, Any]:
+        """将配置内容转换为字典
+
+        返回
+        ====
+        Dict[str, Any]
+            配置项的字典表示，不包含以下划线开头的私有属性
+        """
+        return {k: v for k, v in self.__dict__.items() if not k.startswith("_")}
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "PluginConfig":
+        """从字典创建配置实例
+
+        参数
+        ====
+        data: Dict[str, Any]
+            包含配置字段的字典
+
+        返回
+        ====
+        PluginConfig
+            配置类的实例
+        """
+
+        # 只保留类中定义的字段
+        field_names = {f.name for f in cls.__dataclass_fields__.values()}
+        filtered_data = {k: v for k, v in data.items() if k in field_names}
+        return cls(**filtered_data)
+
+    def save_to_file(self, file_path: Path) -> None:
+        """保存配置到 TOML 文件
+
+        参数
+        ====
+        file_path: Path
+            目标文件路径；必须以 .toml 为后缀
+
+        异常
+        ====
+        PluginConfigDumpError
+            当文件后缀不是 .toml 或写入失败时抛出
+        """
+        if file_path.suffix.upper() == ".TOML":
+            file_path.parent.mkdir(parents=True, exist_ok=True)
+        else:
+            raise PluginConfigDumpError(
+                "插件配置文件类型不应为`{}`，须为`TOML`格式。".format(file_path.suffix)
+            )
+
+        try:
+            with file_path.open("wb") as f:
+                tomli_w.dump(self.to_dict(), f, multiline_strings=False, indent=4)
+        except Exception as e:
+            raise PluginConfigDumpError(e)
+
+    @classmethod
+    def load_from_file(cls, file_path: Path) -> "PluginConfig":
+        """从 TOML 文件加载配置
+
+        参数
+        ====
+        file_path: Path
+            源文件路径
+
+        返回
+        ====
+        PluginConfig
+            加载后的配置实例
+
+        异常
+        ====
+        PluginConfigLoadError
+            当读取或解析失败时抛出
+        """
+        try:
+            with file_path.open("rb") as f:
+                return cls.from_dict(tomllib.load(f))
+        except Exception as e:
+            raise PluginConfigLoadError(e)
+
+
+@dataclass
+class PluginMetaInformation(ABC):
+    """插件元信息"""
+
+    name: str
+    """插件名称，应为惟一之名"""
+    author: str
+    """插件作者"""
+    description: str
+    """插件简介"""
+    version: Tuple[int, ...]
+    """插件版本号"""
+    type: PluginTypes
+    """插件类型"""
+    license: str = "MIT License"
+    """插件发布时采用的许可协议"""
+    dependencies: Sequence[str] = tuple()
+    """插件是否对其他插件存在依赖"""
+
+
+# ========================
+# 抽象基类
+# ========================
+
+
+class TopPluginBase(ABC):
+    """所有插件的抽象基类"""
+
+    metainfo: PluginMetaInformation
+    """插件元信息"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+        if hasattr(cls, "metainfo"):
+            if not isinstance(cls.metainfo, PluginMetaInformation):
+                raise PluginMetainfoTypeError(
+                    "类`{cls_name}`之属性`metainfo`的类型，必须为`PluginMetaInformation`".format(
+                        cls_name=cls.__name__
+                    )
+                )
+        else:
+            if not cls.__name__.endswith("PluginBase"):
+                raise PluginMetainfoNotFoundError(
+                    "类`{cls_name}`必须定义一个`metainfo`属性。".format(
+                        cls_name=cls.__name__
+                    )
+                )
+
+
+class TopInOutPluginBase(TopPluginBase, ABC):
+    """导入导出用抽象基类"""
+
+    supported_formats: Tuple[str, ...] = tuple()
+    """支持的格式（定义后会自动转大写）"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if hasattr(cls, "supported_formats"):
+            if cls.supported_formats:
+                # 强制转换为大写，并使用元组
+                cls.supported_formats = tuple(map(str.upper, cls.supported_formats))
+            else:
+                cls.supported_formats = tuple()
+        else:
+            raise PluginAttributeNotFoundError(
+                "用于导入导出数据的类`{cls_name}`必须定义一个`supported_formats`属性。".format(
+                    cls_name=cls.__name__
+                )
+            )
+
+    def can_handle_file(self, file_path: Path) -> bool:
+        """判断是否可处理某个文件
+
+        参数
+        ====
+        file_path: Path
+            待检测的文件路径
+
+        返回
+        ====
+        bool
+            若文件后缀已在本类中定义，则返回 True
+        """
+        return file_path.suffix.upper().endswith(self.supported_formats)
+
+    def can_handle_format(self, format_name: str) -> bool:
+        """判断是否可处理某个格式
+
+        参数
+        ====
+        format_name: str
+            格式名称（如 'MIDI', 'WAV'）
+
+        返回
+        ====
+        bool
+            若格式名本类中已经定义，则返回 True
+        """
+        return format_name.upper().endswith(self.supported_formats)
+
+
+class MusicInputPluginBase(TopInOutPluginBase, ABC):
+    """导入用插件抽象基类-完整曲目"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.FUNCTION_MUSIC_IMPORT:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`MusicInputPlugin`继承的，该类的子类应当为一个`PluginType.FUNCTION_MUSIC_IMPORT`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    @abstractmethod
+    def loadbytes(
+        self, bytes_buffer_in: BinaryIO, config: Optional[PluginConfig]
+    ) -> "SingleMusic":
+        """从字节流加载数据到完整曲目
+
+        参数
+        ====
+        bytes_buffer_in: BinaryIO
+            输入的二进制字节流
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        SingleMusic
+            解析得到的完整曲目对象
+        """
+
+        pass
+
+    def load(self, file_path: Path, config: Optional[PluginConfig]) -> "SingleMusic":
+        """从文件加载数据到完整曲目
+
+        参数
+        ====
+        file_path: Path
+            输入文件路径
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        SingleMusic
+            解析得到的完整曲目对象
+        """
+        with file_path.open("rb") as f:
+            return self.loadbytes(f, config)
+
+
+class TrackInputPluginBase(TopInOutPluginBase, ABC):
+    """导入用插件抽象基类-单个音轨"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.FUNCTION_TRACK_IMPORT:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`TrackInputPlugin`继承的，该类的子类应当为一个`PluginType.FUNCTION_TRACK_IMPORT`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    @abstractmethod
+    def loadbytes(
+        self, bytes_buffer_in: BinaryIO, config: Optional[PluginConfig]
+    ) -> "SingleTrack":
+        """从字节流加载音符数据到单个音轨
+
+        参数
+        ====
+        bytes_buffer_in: BinaryIO
+            输入的二进制字节流
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        SingleTrack
+            解析得到的单个音轨对象
+        """
+        pass
+
+    def load(self, file_path: Path, config: Optional[PluginConfig]) -> "SingleTrack":
+        """从文件加载音符数据到单个音轨
+
+        参数
+        ====
+        file_path: Path
+            输入文件路径
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        SingleTrack
+            解析得到的单个音轨对象
+        """
+        with file_path.open("rb") as f:
+            return self.loadbytes(f, config)
+
+
+class MusicOperatePluginBase(TopPluginBase, ABC):
+    """音乐处理用插件抽象基类-完整曲目"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.FUNCTION_MUSIC_OPERATE:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`MusicOperatePlugin`继承的，该类的子类应当为一个`PluginType.FUNCTION_MUSIC_OPERATE`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    @abstractmethod
+    def process(
+        self, data: "SingleMusic", config: Optional[PluginConfig]
+    ) -> "SingleMusic":
+        """处理完整曲目的数据
+
+        参数
+        ====
+        data: SingleMusic
+            待处理的完整曲目
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        SingleMusic
+            处理后的完整曲目
+        """
+        pass
+
+
+class TrackOperatePluginBase(TopPluginBase, ABC):
+    """音乐处理用插件抽象基类-单个音轨"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.FUNCTION_TRACK_OPERATE:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`TrackOperatePlugin`继承的，该类的子类应当为一个`PluginType.FUNCTION_TRACK_OPERATE`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    @abstractmethod
+    def process(
+        self, data: "SingleTrack", config: Optional[PluginConfig]
+    ) -> "SingleTrack":
+        """处理单个音轨的音符数据
+
+        参数
+        ====
+        data: SingleTrack
+            待处理的单个音轨
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        SingleTrack
+            处理后的单个音轨
+        """
+        pass
+
+
+class MusicOutputPluginBase(TopInOutPluginBase, ABC):
+    """导出用插件的抽象基类-完整曲目"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.FUNCTION_MUSIC_EXPORT:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`MusicOutputPlugin`继承的，该类的子类应当为一个`PluginType.FUNCTION_MUSIC_EXPORT`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    @abstractmethod
+    def dumpbytes(
+        self, data: "SingleMusic", config: Optional[PluginConfig]
+    ) -> BinaryIO:
+        """将完整曲目导出为对应格式的字节流
+
+        参数
+        ====
+        data: SingleMusic
+            待导出的完整曲目
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        BinaryIO
+            导出后的二进制字节流
+        """
+        pass
+
+    @abstractmethod
+    def dump(
+        self, data: "SingleMusic", file_path: Path, config: Optional[PluginConfig]
+    ):
+        """将完整曲目导出为对应格式的文件
+
+        参数
+        ====
+        data: SingleMusic
+            待导出的完整曲目
+        file_path: Path
+            输出文件路径
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+        """
+
+        pass
+
+
+class TrackOutputPluginBase(TopInOutPluginBase, ABC):
+    """导出用插件的抽象基类-单个音轨"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.FUNCTION_TRACK_EXPORT:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`TrackOutputPlugin`继承的，该类的子类应当为一个`PluginType.FUNCTION_TRACK_EXPORT`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    @abstractmethod
+    def dumpbytes(
+        self, data: "SingleTrack", config: Optional[PluginConfig]
+    ) -> BinaryIO:
+        """将单个音轨导出为对应格式的字节流
+
+        参数
+        ====
+        data: SingleTrack
+            待导出的单个音轨
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+
+        返回
+        ====
+        BinaryIO
+            导出后的二进制字节流
+        """
+        pass
+
+    @abstractmethod
+    def dump(
+        self, data: "SingleTrack", file_path: Path, config: Optional[PluginConfig]
+    ):
+        """将单个音轨导出为对应格式的文件
+
+        参数
+        ====
+        data: SingleTrack
+            待导出的单个音轨
+        file_path: Path
+            输出文件路径
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+        """
+        pass
+
+
+class ServicePluginBase(TopPluginBase, ABC):
+    """服务插件抽象基类"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.SERVICE:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`ServicePlugin`继承的，该类的子类应当为一个`PluginType.SERVICE`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    @abstractmethod
+    def serve(self, config: Optional[PluginConfig], *args) -> None:
+        """服务插件的运行逻辑
+
+        参数
+        ====
+        config: Optional[PluginConfig]
+            插件配置；**可选**
+        *args: Any
+            其他运行时参数
+        """
+        pass
+
+
+class LibraryPluginBase(TopPluginBase, ABC):
+    """插件依赖库的抽象基类"""
+
+    def __init_subclass__(cls) -> None:
+        super().__init_subclass__()
+
+        if cls.metainfo.type != PluginTypes.LIBRARY:
+            raise PluginMetainfoValueError(
+                "插件类`{cls_name}`是从`LibraryPlugin`继承的，该类的子类应当为一个`PluginType.LIBRARY`类型的插件，而不是`PluginType.{cls_type}`".format(
+                    cls_name=cls.__name__,
+                    cls_type=cls.metainfo.type.name,
+                )
+            )
+
+    # 怎么？
+    # 插件的彼此依赖就不需要什么调用了吧

Musicreater/builtin_plugins/midi_read.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+
+"""
+音·创 v3 内置的 Midi 读取插件
+"""
+
+"""
+版权所有 © 2026 金羿、玉衡Alioth
+Copyright © 2026 Eilles, YuhengAlioth
+
+开源相关声明请见 仓库根目录下的 License.md
+Terms & Conditions: License.md in the root directory
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+import mido
+
+from pathlib import Path
+
+from typing import BinaryIO, Optional
+
+from Musicreater import SingleMusic
+from Musicreater.plugins import (
+    music_input_plugin,
+    PluginConfig,
+    PluginMetaInformation,
+    PluginTypes,
+    MusicInputPluginBase,
+)
+
+
+@music_input_plugin("midi_2_music_plugin")
+class MidiImport2MusicPlugin(MusicInputPluginBase):
+    """Midi 音乐数据导入插件"""
+
+    metainfo = PluginMetaInformation(
+        name="Midi 导入插件",
+        author="金羿、玉衡Alioth",
+        description="从 Midi 文件导入音乐数据",
+        version=(0, 0, 1),
+        type=PluginTypes.FUNCTION_MUSIC_IMPORT,
+        license="Same as Musicreater",
+    )
+
+    supported_formats = ("MID", "MIDI")
+
+    def loadbytes(
+        self, bytes_buffer_in: BinaryIO, config: PluginConfig | None
+    ) -> SingleMusic:
+        midi_file = mido.MidiFile(file=bytes_buffer_in)
+        return SingleMusic()  # =========================== TODO: 等待制作
+
+    def load(self, file_path: Path, config: Optional[PluginConfig]) -> "SingleMusic":
+        """从 Midi 文件导入音乐数据"""
+        midi_file = mido.MidiFile(filename=file_path)
+        return SingleMusic()  # =========================== TODO: 等待制作

Musicreater/data.py

@@ -0,0 +1,786 @@
+# -*- coding: utf-8 -*-
+
+"""
+存储 音·创 v3 的内部数据类
+"""
+
+"""
+版权所有 © 2026 金羿
+Copyright © 2026 Eilles
+
+开源相关声明请见 仓库根目录下的 License.md
+Terms & Conditions: License.md in the root directory
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+# “
+# 把代码 洒落在这里
+# 和音符 留下的沙砾
+# 一点一点爬进你类定义的缝隙
+# ”     —— 乐曲访问 by resnah
+
+import heapq
+from math import sin, cos, asin, radians, degrees, sqrt, atan, inf, ceil
+from dataclasses import dataclass
+from typing import (
+    Optional,
+    Any,
+    List,
+    Tuple,
+    Union,
+    Dict,
+    Set,
+    Sequence,
+    Callable,
+    Generator,
+    Iterable,
+    Iterator,
+    Literal,
+    Hashable,
+    TypeVar,
+)
+from enum import Enum
+
+from .exceptions import SingleNoteDecodeError, ParameterTypeError, ParameterValueError
+from .paramcurve import ParamCurve
+
+T = TypeVar("T")
+
+
+class SoundAtmos:
+    """声源方位类"""
+
+    sound_distance: float
+    """声源距离 方块"""
+
+    sound_azimuth: Tuple[float, float]
+    """声源方位 角度(rV左右 rH上下)"""
+
+    def __init__(
+        self,
+        distance: Optional[float] = None,
+        azimuth: Optional[Tuple[float, float]] = None,
+    ) -> None:
+        """
+        定义一个发声方位
+
+        Parameters
+        ------------
+        distance: float
+            发声源距离玩家的距离（半径 `r`）
+            注：距离越近，音量越高，默认为 0。此参数可以与音量成某种函数关系。
+        azimuth: tuple[float, float]
+            声源方位
+            注：此参数为tuple，包含两个元素，分别表示：
+            `rV`  发声源在竖直（上下）轴上，从玩家视角正前方开始，向顺时针旋转的角度
+            `rH`  发声源在水平（左右）轴上，从玩家视角正前方开始，向上（到达玩家正上方顶点后变为向下，以此类推的旋转）旋转的角度
+        """
+
+        self.sound_azimuth = (azimuth[0] % 360, azimuth[1] % 360) if azimuth else (0, 0)
+        """声源方位"""
+
+        # 如果指定为零，那么为零，但如果不指定或者指定为负数，则为 0.01 的距离
+        self.sound_distance = (
+            (16 if distance > 16 else (distance if distance >= 0 else 0.01))
+            if distance is not None
+            else 0.01
+        )
+        """声源距离"""
+
+    @classmethod
+    def from_displacement(
+        cls,
+        displacement: Optional[Tuple[float, float, float]] = None,
+    ) -> "SoundAtmos":
+
+        if displacement is None:
+            # displacement = (0, 0, 0)
+            return cls()
+        else:
+            r = sqrt(displacement[0] ** 2 + displacement[1] ** 2 + displacement[2] ** 2)
+            if r == 0:
+                return cls(distance=0, azimuth=(0, 0))
+            else:
+                beta_h = round(degrees(asin(displacement[1] / r)), 8)
+                if displacement[2] == 0:
+                    alpha_v = -90 if displacement[0] > 0 else 90
+                else:
+                    alpha_v = round(
+                        degrees(atan(-displacement[0] / displacement[2])), 8
+                    )
+        return cls(distance=r, azimuth=(alpha_v, beta_h))
+
+    @property
+    def position_displacement(self) -> Tuple[float, float, float]:
+        """声像位移，直接可应用于我的世界的相对视角的坐标参考系中（^x ^y ^z）"""
+        dk1 = self.sound_distance * round(cos(radians(self.sound_azimuth[1])), 8)
+        return (
+            -dk1 * round(sin(radians(self.sound_azimuth[0])), 8),
+            self.sound_distance * round(sin(radians(self.sound_azimuth[1])), 8),
+            dk1 * round(cos(radians(self.sound_azimuth[0])), 8),
+        )
+
+
+@dataclass(init=False)
+class SingleNote:
+    """存储单个音符的类"""
+
+    note_pitch: int
+    """midi音高"""
+
+    velocity: int
+    """力度"""
+
+    start_time: int
+    """开始之时 命令刻"""
+
+    duration: int
+    """音符持续时间 命令刻"""
+
+    high_precision_start_time: int
+    """高精度开始时间偏量 1/1250 秒"""
+
+    extra_info: Dict[str, Any]
+    """你觉得放什么好？"""
+
+    def __init__(
+        self,
+        midi_pitch: Optional[int],
+        midi_velocity: int,
+        start_time: int,
+        last_time: int,
+        mass_precision_time: int = 0,
+        extra_information: Dict[str, Any] = {},
+    ):
+        """
+        用于存储单个音符的类
+
+        Parameters
+        ------------
+        midi_pitch: int
+            midi音高
+        midi_velocity: int
+            midi响度(力度)
+        start_time: int
+            开始之时(命令刻)
+            注：此处的时间是用从乐曲开始到当前的刻数
+        last_time: int
+            音符延续时间(命令刻)
+        mass_precision_time: int
+            高精度的开始时间偏移量(1/1250秒)
+        is_percussion: bool
+            是否作为打击乐器
+        extra_information: Dict[str, Any]
+            附加信息，尽量存储为字典
+
+        Returns
+        ---------
+        MineNote 类
+        """
+
+        self.note_pitch: int = 66 if midi_pitch is None else midi_pitch
+        """midi音高"""
+        self.velocity: int = midi_velocity
+        """响度(力度)"""
+        self.start_time: int = start_time
+        """开始之时 命令刻"""
+        self.duration: int = last_time
+        """音符持续时间 命令刻"""
+        self.high_precision_start_time: int = mass_precision_time
+        """高精度开始时间偏量 0.4 毫秒"""
+
+        self.extra_info = extra_information if extra_information else {}
+
+    @classmethod
+    def decode(cls, code_buffer: bytes, is_high_time_precision: bool = True):
+        """自字节码析出 SingleNote 类"""
+        duration_ = (
+            group_1 := int.from_bytes(code_buffer[:6], "big")
+        ) & 0b11111111111111111
+        start_tick_ = (group_1 := group_1 >> 17) & 0b11111111111111111
+        note_velocity_ = (group_1 := group_1 >> 17) & 0b1111111
+        note_pitch_ = (group_1 := group_1 >> 7) & 0b1111111
+
+        try:
+            return cls(
+                midi_pitch=note_pitch_,
+                midi_velocity=note_velocity_,
+                start_time=start_tick_,
+                last_time=duration_,
+                mass_precision_time=code_buffer[6] if is_high_time_precision else 0,
+            )
+        except Exception as e:
+            # 我也不知道为什么这里要放一个异常处理
+            # 之前用到过吗？
+            # —— 2026.01.25 金羿
+            print(
+                "[Exception] 单音符解析错误，字节码`{}`，{}启用高精度时间偏移\n".format(
+                    code_buffer, "已" if is_high_time_precision else "未"
+                )
+            )
+            raise SingleNoteDecodeError(
+                e,
+                "技术信息：\nGROUP1\t`{}`\nCODE_BUFFER\t`{}`".format(
+                    group_1, code_buffer
+                ),
+            )
+
+    def encode(self, is_high_time_precision: bool = True) -> bytes:
+        """
+        将数据打包为字节码
+
+        Parameters
+        ------------
+        is_high_time_precision: bool
+            是否启用高精度，默认为**是**
+
+        Returns
+        ---------
+        bytes
+            打包好的字节码
+        """
+
+        # SingleNote 的字节码
+
+        # note_pitch 7 位 支持到 127
+        # velocity 长度 7 位 支持到 127
+        # start_tick 17 位 支持到 131071 即 109.22583 分钟 合 1.8204305 小时
+        # duration 17 位 支持到 131071 即 109.22583 分钟 合 1.8204305 小时
+        # 共 48 位 合 6 字节
+
+        # high_time_precision（可选）长度 8 位 支持到 255 合 1 字节 支持 1/1250 秒]
+
+        return (
+            (
+                (
+                    ((((self.note_pitch << 7) + self.velocity) << 17) + self.start_time)
+                    << 17
+                )
+                + self.duration
+            ).to_bytes(6, "big")
+            # + self.track_no.to_bytes(1, "big")
+            + (
+                self.high_precision_start_time.to_bytes(1, "big")
+                if is_high_time_precision
+                else b""
+            )
+        )
+
+    def set_info(self, key: Union[str, Sequence[str]], value: Any):
+        """设置附加信息"""
+        if isinstance(key, str):
+            self.extra_info[key] = value
+        elif (
+            isinstance(key, Sequence)
+            and isinstance(value, Sequence)
+            and (k := len(key)) == len(value)
+        ):
+            for i in range(k):
+                self.extra_info[key[i]] = value[i]
+        else:
+            # 提供简单报错就行了，如果放一堆 if 语句，降低处理速度
+            raise ParameterTypeError(
+                "参数类型错误；键：`{}` 值：`{}`".format(key, value)
+            )
+
+    def get_info(self, key: str, default: Any = None) -> Any:
+        """获取附加信息"""
+        return self.extra_info.get(key, default)
+
+    def stringize(self, include_extra_data: bool = False) -> str:
+        return "TrackedNote(Pitch = {}, Velocity = {}, StartTick = {}, Duration = {}, TimeOffset = {}".format(
+            self.note_pitch,
+            self.velocity,
+            self.start_time,
+            self.duration,
+            self.high_precision_start_time,
+        ) + (
+            ", ExtraData = {})".format(self.extra_info) if include_extra_data else ")"
+        )
+
+    # def __list__(self) -> List[int]:
+    # 我不认为这个类应当被作为列表使用
+
+    def __tuple__(
+        self,
+    ) -> Tuple[int, int, int, int, int]:
+        return (
+            self.note_pitch,
+            self.velocity,
+            self.start_time,
+            self.duration,
+            self.high_precision_start_time,
+        )
+
+    def __dict__(self):
+        return {
+            "Pitch": self.note_pitch,
+            "Velocity": self.velocity,
+            "StartTick": self.start_time,
+            "Duration": self.duration,
+            "TimeOffset": self.high_precision_start_time,
+            "ExtraData": self.extra_info,
+        }
+
+    def __eq__(self, other) -> bool:
+        """比较两个音符是否具有相同的属性，不计附加信息"""
+        if not isinstance(other, self.__class__):
+            return False
+        return self.__tuple__() == other.__tuple__()
+
+    def __lt__(self, other) -> bool:
+        """比较自己是否在开始时间上早于另一个音符"""
+        if self.start_time == other.start_tick:
+            return self.high_precision_start_time < other.high_precision_time
+        else:
+            return self.start_time < other.start_tick
+
+    def __gt__(self, other) -> bool:
+        """比较自己是否在开始时间上晚于另一个音符"""
+        if self.start_time == other.start_tick:
+            return self.high_precision_start_time > other.high_precision_time
+        else:
+            return self.start_time > other.start_tick
+
+
+class CurvableParam(str, Enum):
+    """可曲线化的参数枚举类"""
+
+    PITCH = "adjust_note_pitch"
+    VELOCITY = "adjust_note_velocity"
+    VOLUME = "adjust_note_volume"
+    DISTANCE = "adjust_note_sound_distance"
+    LR_PANNING = "adjust_note_leftright_panning_degree"
+    UD_PANNING = "adjust_note_updown_panning_degree"
+
+
+@dataclass
+class MineNote:
+    """我的世界音符对象（仅提供我的世界相关接口）"""
+
+    pitch: float
+    """midi音高"""
+    instrument: str
+    """乐器ID"""
+    velocity: float
+    """力度"""
+    volume: float
+    """音量"""
+    start_tick: int
+    """开始之时 命令刻"""
+    duration_tick: int
+    """音符持续时间 命令刻"""
+    persiced_time: int
+    """高精度开始时间偏量 1/1250 秒"""
+    percussive: bool
+    """是否作为打击乐器启用"""
+    position: SoundAtmos
+    """声像方位"""
+
+    @classmethod
+    def from_single_note(
+        cls,
+        note: SingleNote,
+        note_instrument: str,
+        sound_volume: float,
+        is_persiced_time: bool,
+        is_percussive_note: bool,
+        sound_position: SoundAtmos,
+        adjust_note_pitch: float = 0.0,
+        adjust_note_velocity: float = 0.0,
+        adjust_note_volume: float = 0.0,
+        adjust_note_sound_distance: float = 0.0,
+        adjust_note_leftright_panning_degree: float = 0.0,
+        adjust_note_updown_panning_degree: float = 0.0,
+    ) -> "MineNote":
+        """从SingleNote对象创建MineNote对象"""
+        sound_position.sound_distance += adjust_note_sound_distance
+        sound_position.sound_azimuth = (
+            sound_position.sound_azimuth[0] + adjust_note_leftright_panning_degree,
+            sound_position.sound_azimuth[1] + adjust_note_updown_panning_degree,
+        )
+        return cls(
+            pitch=note.note_pitch + adjust_note_pitch,
+            instrument=note_instrument,
+            velocity=note.velocity + adjust_note_velocity,
+            volume=sound_volume + adjust_note_volume,
+            start_tick=note.start_time,
+            duration_tick=note.duration,
+            persiced_time=note.high_precision_start_time if is_persiced_time else 0,
+            percussive=is_percussive_note,
+            position=sound_position,
+        )
+
+
+class SingleTrack(List[SingleNote]):
+    """存储单个轨道的类"""
+
+    track_name: str
+    """轨道之名称"""
+
+    is_enabled: bool = True
+    """该音轨是否启用"""
+
+    track_instrument: str
+    """乐器ID"""
+
+    track_volume: float
+    """该音轨的音量"""
+
+    is_high_time_precision: bool
+    """该音轨是否使用高精度时间"""
+
+    is_percussive: bool
+    """该音轨是否标记为打击乐器轨道"""
+
+    sound_position: SoundAtmos
+    """声像方位"""
+
+    argument_curves: Dict[CurvableParam, Union[ParamCurve, Literal[None]]]
+    """参数曲线"""
+
+    extra_info: Dict[str, Any]
+    """你觉得放什么好？"""
+
+    def __init__(
+        self,
+        name: str = "未命名音轨",
+        instrument: str = "",
+        volume: float = 0,
+        precise_time: bool = True,
+        percussion: bool = False,
+        sound_direction: SoundAtmos = SoundAtmos(),
+        extra_information: Dict[str, Any] = {},
+        *args: SingleNote,
+    ):
+        self.track_name = name
+        """音轨名称"""
+
+        self.track_instrument = instrument
+        """乐器ID"""
+
+        self.track_volume = volume
+        """音量"""
+
+        self.is_high_time_precision = precise_time
+        """是否使用高精度时间"""
+
+        self.is_percussive = percussion
+        """是否为打击乐器"""
+
+        self.sound_position = sound_direction
+        """声像方位"""
+
+        self.extra_info = extra_information if extra_information else {}
+
+        self.argument_curves = {item: None for item in CurvableParam}
+
+        super().__init__(*args)
+        super().sort()
+
+    def disable(self) -> None:
+        """禁用音轨"""
+
+        self.is_enabled = False
+
+    def enable(self) -> None:
+        """启用音轨"""
+
+        self.is_enabled = True
+
+    def toggle_able(self) -> None:
+        """切换音轨的启用状态"""
+
+        self.is_enabled = not self.is_enabled
+
+    def append(self, object: SingleNote) -> None:
+        """
+        添加一个音符，推荐使用 add 方法
+        """
+
+        return self.add(object)
+
+    def add(self, item: SingleNote) -> None:
+        """
+        在音轨里添加一个音符
+        """
+
+        if not isinstance(item, SingleNote):
+            raise ParameterTypeError(
+                "单音轨类的元素类型须为单音符（`SingleNote`），不可为：`{}`".format(
+                    type(item).__name__
+                )
+            )
+        super().append(item)
+        super().sort()  # =========================== TODO 需要优化
+
+    def update(self, items: Iterable[SingleNote]):
+        """
+        拼接两个音轨
+        """
+        super().extend(items)
+        super().sort()  # =========================== TODO 需要优化
+
+    def get(self, time: int) -> Generator[SingleNote, None, None]:
+        """通过开始时间来获取音符"""
+
+        return (x for x in self if x.start_time == time)
+
+    def get_notes(
+        self, start_time: float, end_time: float = inf
+    ) -> Generator[SingleNote, None, None]:
+        """通过开始时间和结束时间来获取音符"""
+        if end_time < start_time:
+            raise ParameterValueError(
+                "获取音符的时间范围有误，终止时间`{}`早于起始时间`{}`".format(
+                    end_time, start_time
+                )
+            )
+        elif start_time < 0 or end_time < 0:
+            raise ParameterValueError(
+                "获取音符的时间范围有误，终止时间`{}`和起始时间`{}`皆不可为负数".format(
+                    end_time, start_time
+                )
+            )
+        return (
+            x
+            for x in self
+            if (x.start_time >= start_time) and (x.start_time <= end_time)
+        )
+
+    def get_minenotes(
+        self, range_start_time: float = 0, range_end_time: float = inf
+    ) -> Generator[MineNote, Any, None]:
+        """获取能够用以在我的世界播放的音符数据类"""
+
+        for _note in self.get_notes(range_start_time, range_end_time):
+            yield MineNote.from_single_note(
+                note=_note,
+                note_instrument=self.track_instrument,
+                sound_volume=self.track_volume,
+                is_persiced_time=self.is_high_time_precision,
+                is_percussive_note=self.is_percussive,
+                sound_position=self.sound_position,
+                **{
+                    item.value: argcrv.value_at(_note.start_time)
+                    for item in CurvableParam
+                    if (argcrv := self.argument_curves[item])
+                },
+            )
+
+    @property
+    def note_amount(self) -> int:
+        """音符数"""
+        return len(self)
+
+    @property
+    def track_notes(self) -> List[SingleNote]:
+        """音符列表"""
+        return self
+
+    def set_info(self, key: Union[str, Sequence[str]], value: Any):
+        """设置附加信息"""
+        if isinstance(key, str):
+            self.extra_info[key] = value
+        elif (
+            isinstance(key, Sequence)
+            and isinstance(value, Sequence)
+            and (k := len(key)) == len(value)
+        ):
+            for i in range(k):
+                self.extra_info[key[i]] = value[i]
+        else:
+            # 提供简单报错就行了，如果放一堆 if 语句，降低处理速度
+            raise ParameterTypeError(
+                "参数类型错误；键：`{}` 值：`{}`".format(key, value)
+            )
+
+    def get_info(self, key: str, default: Any = None) -> Any:
+        """获取附加信息"""
+        return self.extra_info.get(key, default)
+
+
+class SingleMusic(List[SingleTrack]):
+    """存储单个曲子的类"""
+
+    music_name: str
+    """乐曲名称"""
+
+    music_creator: str
+    """本我的世界曲目的制作者"""
+
+    music_original_author: str
+    """曲目的原作者"""
+
+    music_description: str
+    """当前曲目的简介"""
+
+    music_credits: str
+    """曲目的版权信息"""
+
+    # 感叹一下什么交冗余设计啊！（叉腰）
+    extra_info: Dict[str, Any]
+    """这还得放东西？"""
+
+    def __init__(
+        self,
+        name: str = "未命名乐曲",
+        creator: str = "未命名制作者",
+        original_author: str = "未命名原作者",
+        description: str = "未命名简介",
+        credits: str = "未命名版权信息",
+        *args: SingleTrack,
+        extra_information: Dict[str, Any] = {},
+    ):
+        self.music_name = name
+        """乐曲名称"""
+
+        self.music_creator = creator
+        """曲目制作者"""
+
+        self.music_original_author = original_author
+        """乐曲原作者"""
+
+        self.music_description = description
+        """简介"""
+
+        self.music_credits = credits
+        """版权信息"""
+
+        self.extra_info = extra_information if extra_information else {}
+
+        super().__init__(*args)
+
+    @property
+    def track_amount(self) -> int:
+        """音轨数"""
+        return len(self)
+
+    @property
+    def music_tracks(self) -> Iterator[SingleTrack]:
+        """音轨列表，不包含被禁用的音轨"""
+        return (track for track in self if track.is_enabled)
+
+    @staticmethod
+    def yield_from_tracks(
+        tracks: Sequence[Iterator[T]],
+        sort_key: Callable[[T], Any],
+        is_subseq_sorted: bool = True,
+    ) -> Iterator[T]:
+        """从任意迭代器列表迭代符合顺序的元素
+        （惰性多路归并多个迭代器，按 sort_key 排序）
+
+        参数
+        ----
+        tracks: Sequence[Iterator[T]]
+            迭代器列表
+        sort_key: Callable[[T], Any]
+            接受 T 元素，返回可比较的键
+        is_subseq_sorted: bool = True
+            子序列是否已排序
+
+        迭代
+        ----
+            归并后的每个元素，按 sort_key 升序
+        """
+        if is_subseq_sorted:
+            return heapq.merge(*tracks, key=sort_key)
+        else:
+            # 初始化堆
+            heap_pool: List[Tuple[Any, int, T]] = []
+            for _index, _track in enumerate(tracks):
+                try:
+                    item = next(_track)
+                    heapq.heappush(heap_pool, (sort_key(item), _index, item))
+                except StopIteration:
+                    continue
+
+            # 归并主循环
+            while heap_pool:
+                _key, _index, item = heapq.heappop(heap_pool)
+                yield item
+                try:
+                    next_item = next(tracks[_index])
+                    heapq.heappush(heap_pool, (sort_key(next_item), _index, next_item))
+                except StopIteration:
+                    pass
+        # NEVER REACH:
+        # pool: List[Tuple[str, T]] = []
+        # remove_track: List[str] = []
+        # for _name, _track in tracks.items():
+        #     try:
+        #         pool.append((_name, next(_track)))
+        #     except StopIteration:
+        #         remove_track.append(_name)
+        # for _x in remove_track:
+        #     tracks.pop(_x)
+        # del remove_track
+        # while tracks and pool:
+        #     yield (_x := min(pool, key=sort_key))[1]
+        #     try:
+        #         pool.append((_x[0], next(tracks[_x[0]])))
+        #     except StopIteration:
+        #         tracks.pop(_x[0])
+        # pool.sort(key=sort_key)
+        # for _remain in pool:
+        #     yield _remain[1]
+
+    def get_tracked_notes(
+        self, start_time: float, end_time: float = inf
+    ) -> Generator[Iterator[SingleNote], Any, None]:
+        """获取指定时间段的各个音轨的音符数据"""
+        return (track.get_notes(start_time, end_time) for track in self.music_tracks)
+
+    def get_tracked_minenotes(
+        self, start_time: float, end_time: float = inf
+    ) -> Generator[Iterator[MineNote], Any, None]:
+        """获取指定时间段的各个音轨的，供我的世界播放的音符数据类"""
+        return (
+            track.get_minenotes(start_time, end_time) for track in self.music_tracks
+        )
+
+    def get_notes(
+        self, start_time: float, end_time: float = inf
+    ) -> Iterator[SingleNote]:
+        """获取指定时间段的所有音符数据，按照时间顺序"""
+        if self.track_amount == 0:
+            return iter(())
+        return self.yield_from_tracks(
+            [track.get_notes(start_time, end_time) for track in self.music_tracks],
+            sort_key=lambda x: x.start_time,
+        )
+
+    def get_minenotes(
+        self, start_time: float, end_time: float = inf
+    ) -> Generator[MineNote, Any, None]:
+        """获取指定时间段所有的，供我的世界播放的音符数据类，按照时间顺序"""
+        if self.track_amount == 0:
+            return
+        yield from self.yield_from_tracks(
+            [track.get_minenotes(start_time, end_time) for track in self.music_tracks],
+            sort_key=lambda x: x.start_tick,
+        )
+
+    def set_info(self, key: Union[str, Sequence[str]], value: Any):
+        """设置附加信息"""
+        if isinstance(key, str):
+            self.extra_info[key] = value
+        elif (
+            isinstance(key, Sequence)
+            and isinstance(value, Sequence)
+            and (k := len(key)) == len(value)
+        ):
+            for i in range(k):
+                self.extra_info[key[i]] = value[i]
+        else:
+            # 提供简单报错就行了，如果放一堆 if 语句，降低处理速度
+            raise ParameterTypeError(
+                "参数类型错误；键：`{}` 值：`{}`".format(key, value)
+            )
+
+    def get_info(self, key: str, default: Any = None) -> Any:
+        """获取附加信息"""
+        return self.extra_info.get(key, default)

Musicreater/exceptions.py

@@ -0,0 +1,266 @@
+# -*- coding: utf-8 -*-
+
+"""
+存储 音·创 v3 用到的一些报错类型
+"""
+
+"""
+版权所有 © 2026 金羿 & 玉衡Alioth
+Copyright © 2026 Eilles & YuhengAlioth
+
+开源相关声明请见 仓库根目录下的 License.md
+Terms & Conditions: License.md in the root directory
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+# “
+# There are planty of "exception"s in this library
+# for I know I will always go with my heart.
+# ”     —— Cyberdevil by resnah
+
+
+class MusicreaterBaseException(Exception):
+    """音·创 v3 的所有错误均继承于此"""
+
+    def __init__(self, *args):
+        """音·创 的所有错误均继承于此"""
+        super().__init__("[音·创] - ", *args)
+
+    def meow(self):
+        for i in self.args:
+            print(i + "喵~", end="：")
+
+    def crash_it(self):
+        raise self
+
+    def __str__(self) -> str:
+        return "".join(self.args)
+
+
+# =====================================
+# NOTE
+# 面对用户时候爆出去的我们认为这就是“外部错误”
+# 如果是在程序内部数据传输等情况下出现的就是“内部错误”
+# 例如，无法读取文件，这就是一个外部错误
+# 某个参数的数据类型错误，这就是内部错误
+# =====================================
+
+
+class MusicreaterInnerlyError(MusicreaterBaseException):
+    """内部错误"""
+
+    def __init__(self, *args):
+        """内部错误（面向开发者的报错信息）"""
+        super().__init__("内部错误 - ", *args)
+
+
+class MusicreaterOuterlyError(MusicreaterBaseException):
+    """外部错误"""
+
+    def __init__(self, *args):
+        """外部错误（面向用户的报错信息）"""
+        super().__init__("外部错误 - ", *args)
+
+
+class InnerlyParameterError(MusicreaterInnerlyError):
+    """内部传参错误"""
+
+    def __init__(self, *args):
+        """参数错误"""
+        super().__init__("传参错误 - ", *args)
+
+
+class ParameterTypeError(InnerlyParameterError, TypeError):
+    """参数类型错误"""
+
+    def __init__(self, *args):
+        """参数类型错误"""
+        super().__init__("参数类型错误：", *args)
+
+
+class ParameterValueError(InnerlyParameterError, ValueError):
+    """参数值存在错误"""
+
+    def __init__(self, *args):
+        """参数其值存在错误"""
+        super().__init__("参数数值错误：", *args)
+
+
+class PluginNotSpecifiedError(InnerlyParameterError, LookupError):
+    """未指定插件"""
+
+    def __init__(self, *args):
+        """未指定插件"""
+        super().__init__("未指定插件：", *args)
+
+
+class OuterlyParameterError(MusicreaterOuterlyError):
+    """外部参数错误"""
+
+    def __init__(self, *args):
+        """参数错误"""
+        super().__init__("参数错误 - ", *args)
+
+
+class ZeroSpeedError(OuterlyParameterError, ZeroDivisionError):
+    """以0作为播放速度的错误"""
+
+    def __init__(self, *args):
+        """以0作为播放速度的错误"""
+        super().__init__("播放速度为零：", *args)
+
+
+class IllegalMinimumVolumeError(OuterlyParameterError, ValueError):
+    """最小播放音量有误的错误"""
+
+    def __init__(self, *args):
+        """最小播放音量错误"""
+        super().__init__("最小播放音量超出范围：", *args)
+
+
+class FileFormatNotSupportedError(MusicreaterOuterlyError):
+    """不支持的文件格式"""
+
+    def __init__(self, *args):
+        """文件格式不受支持"""
+        super().__init__("不支持的文件格式：", *args)
+
+
+class NoteBinaryDecodeError(MusicreaterOuterlyError):
+    """音乐存储二进制数据解码错误"""
+
+    def __init__(self, *args):
+        """音乐存储二进制数据无法正确解码"""
+        super().__init__("解码音乐存储二进制数据时出现问题 - ", *args)
+
+
+class SingleNoteDecodeError(NoteBinaryDecodeError):
+    """单个音符的二进制数据解码错误"""
+
+    def __init__(self, *args):
+        """单个音符的二进制数据无法正确解码"""
+        super().__init__("音符解码出错：", *args)
+
+
+class NoteBinaryFileTypeError(NoteBinaryDecodeError):
+    """音乐存储二进制数据的文件类型错误"""
+
+    def __init__(self, *args):
+        """无法识别音乐存储文件的类型"""
+        super().__init__("无法识别音乐存储文件对应的类型：", *args)
+
+
+class NoteBinaryFileVerificationFailed(NoteBinaryDecodeError):
+    """音乐存储二进制数据校验失败"""
+
+    def __init__(self, *args):
+        """音乐存储文件与其校验值不一致"""
+        super().__init__("音乐存储文件校验失败：", *args)
+
+
+class PluginDefineError(MusicreaterInnerlyError):
+    """插件定义错误（内部相关）"""
+
+    def __init__(self, *args):
+        """插件本身存在错误"""
+        super().__init__("插件内部错误 - ", *args)
+
+
+class PluginInstanceNotFoundError(PluginDefineError, LookupError):
+    """插件实例未找到"""
+
+    def __init__(self, *args):
+        """插件实例未找到"""
+        super().__init__("插件实例未找到：", *args)
+
+
+class PluginAttributeNotFoundError(PluginDefineError, AttributeError):
+    """插件属性定义错误"""
+
+    def __init__(self, *args):
+        """插件属性定义错误"""
+        super().__init__("插件类的必要属性不存在：", *args)
+
+
+class PluginMetainfoError(PluginDefineError):
+    """插件元信息定义错误"""
+
+    def __init__(self, *args):
+        """插件元信息定义错误"""
+        super().__init__("插件元信息定义错误 - ", *args)
+
+
+class PluginMetainfoTypeError(PluginMetainfoError, TypeError):
+    """插件元信息定义类型错误"""
+
+    def __init__(self, *args):
+        """插件元信息定义类型错误"""
+        super().__init__("插件元信息类型错误：", *args)
+
+
+class PluginMetainfoValueError(PluginMetainfoError, ValueError):
+    """插件元信息定义值错误"""
+
+    def __init__(self, *args):
+        """插件元信息定义值错误"""
+        super().__init__("插件元信息数值错误：", *args)
+
+
+class PluginMetainfoNotFoundError(PluginMetainfoError, PluginAttributeNotFoundError):
+    """插件元信息定义缺少错误"""
+
+    def __init__(self, *args):
+        """插件元信息定义缺少错误"""
+        super().__init__("插件元信息未定义：", *args)
+
+
+class PluginLoadError(MusicreaterOuterlyError):
+    """插件加载错误（外部相关）"""
+
+    def __init__(self, *args):
+        """插件加载错误"""
+        super().__init__("插件加载错误 - ", *args)
+
+
+class PluginNotFoundError(PluginLoadError):
+    """插件未找到"""
+
+    def __init__(self, *args):
+        """插件未找到"""
+        super().__init__("插件未找到：", *args)
+
+
+class PluginRegisteredError(PluginLoadError):
+    """插件重复注册"""
+
+    def __init__(self, *args):
+        """插件已被注册注册"""
+        super().__init__("插件重复注册：", *args)
+
+
+
+class PluginConfigRelatedError(MusicreaterOuterlyError):
+    """插件配置相关错误"""
+
+    def __init__(self, *args):
+        """插件配置相关错误"""
+        super().__init__("插件配置相关错误 - ", *args)
+
+
+class PluginConfigLoadError(PluginLoadError, PluginConfigRelatedError):
+    """插件配置加载错误"""
+
+    def __init__(self, *args):
+        """配置文件无法加载"""
+        super().__init__("插件配置文件加载错误：", *args)
+
+
+class PluginConfigDumpError(PluginConfigRelatedError):
+    """插件配置保存错误"""
+
+    def __init__(self, *args):
+        """配置文件无法保存"""
+        super().__init__("插件配置文件保存错误：", *args)

Musicreater/main.py

@@ -0,0 +1,285 @@
+# -*- coding: utf-8 -*-
+
+
+"""
+音·创
+是一款免费开源的《我的世界》数字音频支持库。
+
+Musicreater (音·创)
+A free and open-source library for handling with **Minecraft** digital music.
+
+版权所有 © 2026 睿乐组织
+Copyright © 2026 TriM-Organization
+
+音·创（“本项目”）的协议颁发者为 金羿、玉衡Alioth
+The Licensor of Musicreater("this project") is Eilles, YuhengAlioth
+
+本项目根据 第一版 汉钰律许可协议（“本协议”）授权。
+任何人皆可从以下地址获得本协议副本：
+https://gitee.com/TriM-Organization/Musicreater/blob/master/LICENSE.md。
+若非因法律要求或经过了特殊准许，此作品在根据本协议“原样”提供的基础上，
+不予提供任何形式的担保、任何明示、任何暗示或类似承诺。
+也就是说，用户将自行承担因此作品的质量或性能问题而产生的全部风险。
+详细的准许和限制条款请见原协议文本。
+"""
+
+# 音·创 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库根目录下的 License.md
+
+
+# BUG退散！BUG退散！
+# 异常与错误作乱之时
+# 二六字组！万国码合！二六字组！万国码合！
+# 赶快呼叫 程序员！Let's Go！
+
+# BUG退散！BUG退散！
+# 異常、誤りが、困った時は
+# パラメータ メソッド！パラメータ メソッド！
+# 助けてもらおう、開発者！レッツゴー！
+
+# Bug retreat! Bug retreat!
+# Exceptions and errors are causing chaos
+# Words combine! Codes unite!
+# Hurry to call the programmer! Let's Go!
+
+import re
+
+
+from difflib import get_close_matches
+from typing import Dict, Generator, List, Optional, Tuple, Union, Mapping, Callable
+from pathlib import Path
+
+
+from .data import SingleMusic, SingleTrack
+from .exceptions import (
+    FileFormatNotSupportedError,
+    PluginNotSpecifiedError,
+    PluginNotFoundError,
+)
+from ._plugin_abc import TopPluginBase
+from .plugins import (
+    _global_plugin_registry,
+    PluginRegistry,
+    PluginConfig,
+    PluginTypes,
+    load_plugin_module,
+    T_IOPlugin,
+    T_Plugin,
+)
+
+
+class MusiCreater:
+    """
+    音·创 v3 主要控制类
+    另：“创建者”一词的英文应该是“Creator”
+    """
+
+    __plugin_registry: PluginRegistry
+    """插件注册表实例"""
+    _plugin_cache: Dict[str, TopPluginBase]
+    """插件缓存字典，插件id为键、插件实例为值"""
+    music: SingleMusic
+    """当前曲目实例"""
+
+    def __init__(self, whole_music: SingleMusic) -> None:
+        global _global_plugin_registry
+
+        self.__plugin_registry = _global_plugin_registry
+
+        self._plugin_cache = {}
+        self._cache_all_plugins()
+
+        self.music = whole_music
+
+    @staticmethod
+    def _get_plugin_within_iousage(
+        get_func: Callable[[Union[Path, str]], Generator[T_IOPlugin, None, None]],
+        fpath: Path,
+        plg_regdict: Dict[str, T_IOPlugin],
+        plg_id: Optional[str],
+    ) -> T_IOPlugin:
+
+        __plugin: Optional[T_IOPlugin] = None
+        if plg_id:
+            __plugin = plg_regdict.get(plg_id)
+
+        else:
+            for __plg in get_func(fpath):
+                if __plugin:
+                    raise PluginNotSpecifiedError(
+                        "文件类型`{}`可被多个插件处理，请在调用函数的参数中指定插件名称".format(
+                            fpath.suffix.upper()
+                        )
+                    )
+                __plugin = __plg
+        if __plugin:
+            return __plugin
+        else:
+            raise FileFormatNotSupportedError(
+                "无法找到处理`{}`类型文件的插件".format(fpath.suffix.upper())
+            )
+
+    @classmethod
+    def import_music(
+        cls,
+        file_path: Path,
+        plugin_id: Optional[str] = None,
+        plugin_config: Optional[PluginConfig] = None,
+    ) -> "MusiCreater":
+        return cls(
+            whole_music=cls._get_plugin_within_iousage(
+                _global_plugin_registry.get_music_input_plugin_by_format,
+                file_path,
+                _global_plugin_registry._music_input_plugins,
+                plugin_id,
+            ).load(file_path, plugin_config)
+        )
+
+    def import_track(
+        self,
+        file_path: Path,
+        plugin_id: Optional[str] = None,
+        plugin_config: Optional[PluginConfig] = None,
+    ) -> SingleTrack:
+        self.music.append(
+            self._get_plugin_within_iousage(
+                self.__plugin_registry.get_track_input_plugin_by_format,
+                file_path,
+                self.__plugin_registry._track_input_plugins,
+                plugin_id,
+            ).load(file_path, plugin_config)
+        )
+        return self.music[-1]
+
+    def export_music(
+        self,
+        file_path: Path,
+        plugin_id: Optional[str] = None,
+        plugin_config: Optional[PluginConfig] = None,
+    ) -> None:
+        self._get_plugin_within_iousage(
+            self.__plugin_registry.get_music_output_plugin_by_format,
+            file_path,
+            self.__plugin_registry._music_output_plugins,
+            plugin_id,
+        ).dump(self.music, file_path, plugin_config)
+
+    def export_track(
+        self,
+        track_index: int,
+        file_path: Path,
+        plugin_id: Optional[str] = None,
+        plugin_config: Optional[PluginConfig] = None,
+    ) -> None:
+        self._get_plugin_within_iousage(
+            self.__plugin_registry.get_track_output_plugin_by_format,
+            file_path,
+            self.__plugin_registry._track_output_plugins,
+            plugin_id,
+        ).dump(self.music[track_index], file_path, plugin_config)
+
+    def perform_operation_on_music(
+        self, plugin_id: str, plugin_config: Optional[PluginConfig] = None
+    ):
+        if __plugin := self.__plugin_registry._music_operate_plugins.get(plugin_id):
+            # 这样做是为了兼容以后的*撤回/重做*功能
+            self.music = __plugin.process(self.music, plugin_config)
+        else:
+            raise PluginNotFoundError(
+                "无法找到惟一识别码为`{}`的插件".format(plugin_id)
+            )
+
+    def perform_operation_on_track(
+        self,
+        track_index: int,
+        plugin_id: str,
+        plugin_config: Optional[PluginConfig] = None,
+    ):
+        if __plugin := self.__plugin_registry._track_operate_plugins.get(plugin_id):
+            # 这样做是为了兼容以后的*撤回/重做*功能
+            self.music[track_index] = __plugin.process(
+                self.music[track_index], plugin_config
+            )
+        else:
+            raise PluginNotFoundError(
+                "无法找到惟一识别码为`{}`的插件".format(plugin_id)
+            )
+
+    @staticmethod
+    def _camel_to_snake(name: str) -> str:
+        """
+        将驼峰命名转换为蛇形命名
+        CyberAngel -> cyber_angel
+        """
+        return re.sub(
+            "([a-z0-9])([A-Z])", r"\1_\2", re.sub("(.)([A-Z][a-z]+)", r"\1_\2", name)
+        ).lower()
+
+    def _parse_plugin_id(self, attr_name: str) -> Optional[str]:
+        """解析属性名称为插件惟一识别码"""
+
+        # 尝试去除 _plugin 后缀
+        if attr_name.endswith("_plugin"):
+            candidate_name = attr_name[:-7]  # 去除 "_plugin"
+            if candidate_name in self._plugin_cache:
+                return candidate_name
+
+        # 尝试转换为 snake_case（如果插件名是驼峰式）
+        snake_case_name = self._camel_to_snake(attr_name)
+
+        if snake_case_name != attr_name:  # 避免重复转换
+            if snake_case_name in self._plugin_cache:  # 尝试转换后的插件名
+                return snake_case_name
+            else:
+                return self._parse_plugin_id(snake_case_name)
+
+        return None
+
+    def _get_closest_plugin_id(self, requested_id: str) -> Optional[str]:
+        """找到最接近的插件识别码（用于更好的错误提示）"""
+
+        matches = get_close_matches(
+            requested_id, self._plugin_cache.keys(), n=1, cutoff=0.6
+        )
+        return matches[0] if matches else None
+
+    def get_plugin_by_id(self, plg_id: str):
+        """获取插件实例，并缓存起来，提高性能"""
+        if plg_id.startswith("_"):
+            raise AttributeError("属性`{}`不存在，不应访问类的私有属性".format(plg_id))
+
+        if plg_id in self._plugin_cache:
+            return self._plugin_cache[plg_id]
+        else:
+            plugin_name = self._parse_plugin_id(plg_id)
+            if plugin_name:
+                self._plugin_cache[plg_id] = self._plugin_cache[plugin_name]
+                return self._plugin_cache[plg_id]
+
+        closest = self._get_closest_plugin_id(plg_id)
+
+        raise AttributeError(
+            "插件`{}`不存在，请检查插件的惟一识别码是否正确".format(plg_id)
+            + (
+                "；或者阁下可能想要使用的是`{}`插件？".format(closest)
+                if closest
+                else ""
+            )
+        )
+
+    def __getattr__(self, plugin_id: str):
+        """动态属性访问，允许直接 实例.插件名 来访问插件"""
+        return self.get_plugin_by_id(plugin_id)
+
+    def _cache_all_plugins(self):
+        """获取所有已注册插件的名称"""
+        for __plugin_type, __plugins_map in self.__plugin_registry:
+            for __plugin_id, __plugin in __plugins_map.items():
+                if __plugin_id in self._plugin_cache:  # 避免重复缓存
+                    if (
+                        __plugin.metainfo.version
+                        <= self._plugin_cache[__plugin_id].metainfo.version
+                    ):  # 优先使用版本号最大的插件
+                        continue
+                self._plugin_cache[__plugin_id] = __plugin

Musicreater/paramcurve.py

@@ -0,0 +1,583 @@
+# -*- coding: utf-8 -*-
+
+"""
+存储 音·创 v3 内部数据使用的参数曲线
+"""
+
+"""
+版权所有 © 2026 金羿
+Copyright © 2026 Eilles
+
+开源相关声明请见 仓库根目录下的 License.md
+Terms & Conditions: License.md in the root directory
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+
+# WARNING 本文件所含之功能未经完整测试
+# 鉴于白谭若佬给出的建议：本功能应是处于低优先级开发的
+# 因此暂时用处不大，可以稍微放一会再进行开发
+# 目前用人工智能生成了部分代码，只经过简单的测试
+# 可以等伶伦工作站开发出来后再进行完整的测试
+
+
+from math import ceil
+from dataclasses import dataclass
+from typing import Optional, Any, List, Tuple
+from enum import Enum
+import bisect
+
+from .types import FittingFunctionType
+
+
+def _evaluate_bezier_segment(
+    t0: float,
+    v0: float,
+    t1: float,
+    v1: float,
+    out_tangent: Optional[Tuple[float, float]],
+    in_tangent: Optional[Tuple[float, float]],
+    u: float,
+) -> float:
+    """
+    计算贝塞尔区间 [t0, t1] 在归一化参数 u ∈ [0,1] 处的 y 值。
+
+    控制点：
+      P0 = (t0, v0)
+      P1 = (t0 + out_dt, v0 + out_dv)
+      P2 = (t1 - in_dt, v1 - in_dv)   ← 注意：in_tangent 是相对于 t1 的偏移
+      P3 = (t1, v1)
+    """
+    # 默认控制点：退化为线性
+    p0 = (t0, v0)
+    p3 = (t1, v1)
+
+    if out_tangent is not None:
+        p1 = (t0 + out_tangent[0], v0 + out_tangent[1])
+    else:
+        p1 = p0  # 无出手柄 → 与起点重合
+
+    if in_tangent is not None:
+        p2 = (t1 - in_tangent[0], v1 - in_tangent[1])
+    else:
+        p2 = p3  # 无入手柄 → 与终点重合
+
+    # 三次贝塞尔 y(t)
+    mt = 1.0 - u
+    return mt**3 * p0[1] + 3 * mt**2 * u * p1[1] + 3 * mt * u**2 * p2[1] + u**3 * p3[1]
+
+
+class InterpolationMethod:
+    """
+    预定义的标准化插值函数集合。所有函数接受归一化输入 u ∈ [0,1]，返回 v ∈ [0,1]。
+    """
+
+    @staticmethod
+    def linear(u: float) -> float:
+        """
+        线性插值。
+
+        Parameters
+        ----------
+        u : float
+            归一化时间，范围 [0, 1]。
+
+        Returns
+        -------
+        float
+            插值权重，范围 [0, 1]。
+        """
+        return u
+
+    @staticmethod
+    def ease_in_quad(u: float) -> float:
+        """
+        二次缓入（慢进快出）。
+
+        Parameters
+        ----------
+        u : float
+            归一化时间，范围 [0, 1]。
+
+        Returns
+        -------
+        float
+            插值权重。
+        """
+        return u * u
+
+    @staticmethod
+    def ease_out_quad(u: float) -> float:
+        """
+        二次缓出（快进慢出）。
+
+        Parameters
+        ----------
+        u : float
+            归一化时间，范围 [0, 1]。
+
+        Returns
+        -------
+        float
+            插值权重。
+        """
+        return 1 - (1 - u) ** 2
+
+    @staticmethod
+    def ease_in_out_quad(u: float) -> float:
+        """
+        二次缓入缓出。
+
+        Parameters
+        ----------
+        u : float
+            归一化时间，范围 [0, 1]。
+
+        Returns
+        -------
+        float
+            插值权重。
+        """
+        if u < 0.5:
+            return 2 * u * u
+        else:
+            return 1 - pow(-2 * u + 2, 2) / 2
+
+    @staticmethod
+    def hold(u: float) -> float:
+        """
+        阶梯保持模式占位函数。实际插值逻辑在 ParamCurve.value_at 中特殊处理。
+
+        Parameters
+        ----------
+        u : float
+            归一化时间（忽略）。
+
+        Returns
+        -------
+        float
+            无意义，仅作标识。
+        """
+        return 0.0
+
+
+@dataclass
+class Keyframe:
+    """
+    参数曲线上的一个关键帧，支持完整的入/出切线控制。
+
+    插值优先级：
+    1. 若 use_bezier=True → 使用贝塞尔模式（需 in_tangent / out_tangent）
+    2. 否则 → 使用 out_interp 函数（in_interp 被忽略）
+    """
+
+    time: float
+    value: float
+
+    # 函数插值模式
+    out_interp: Optional[FittingFunctionType] = None
+
+    # 贝塞尔模式
+    in_tangent: Optional[Tuple[float, float]] = (
+        None  # (dt, dv) ← 相对于自身（负 dt 表示左侧）
+    )
+    out_tangent: Optional[Tuple[float, float]] = (
+        None  # (dt, dv) → 相对于自身（正 dt 表示右侧）
+    )
+    use_bezier: bool = False
+
+
+class BoundaryBehaviour(str, Enum):
+    """
+    边界行为枚举。
+    """
+
+    CONSTANT = "constant"
+    """返回默认基线值"""
+    HOLD = "hold"
+    """保持首/尾关键帧的值"""
+
+
+class ParamCurve:
+    """
+    参数曲线类
+    """
+
+    """
+    支持动态节点编辑
+    用户通过添加/修改关键帧（时间-值对）来定义曲线，类自动在相邻关键帧之间生成插值段。
+    支持多种插值模式：线性（'linear'）、平滑缓动（'smooth'）、保持（'hold'）或自定义函数。
+    """
+
+    base_line: float = 0.0
+    """基线/默认值"""
+
+    base_interpolation_function: FittingFunctionType
+    """默认（未指定区间时的）关键帧插值模式"""
+
+    boundary_behaviour: BoundaryBehaviour
+    """边界行为，控制参数曲线在已定义的范围外的返回值"""
+
+    _keys: List[Keyframe]
+    """关键帧列表"""
+
+    def __init__(
+        self,
+        base_value: float = 0.0,
+        default_interpolation_function: FittingFunctionType = InterpolationMethod.linear,
+        boundary_mode: BoundaryBehaviour = BoundaryBehaviour.CONSTANT,
+    ):
+        """
+        初始化参数曲线。
+
+        Parameters
+        ----------
+        base_value : float
+            边界外默认值（当 boundary_mode 为 BoundaryBehaviour.CONSTANT 时使用）。
+        default_interpolation_function : FittingFunctionType
+            新关键帧的默认 out_interp。
+        boundary_mode : BoundaryBehaviour
+            范围外行为：
+            - BoundaryBehaviour.CONSTANT: 返回 base_value
+            - BoundaryBehaviour.HOLD: 保持首/尾关键帧值
+        """
+        self.base_line = base_value
+        self.base_interpolation_function = default_interpolation_function
+        self.boundary_behaviour = boundary_mode
+
+        self._keys: List[Keyframe] = []
+
+    def __bool__(self) -> bool:
+        return bool(self._keys) or (self.base_line != 0)
+
+    def add_key(
+        self,
+        time: float,
+        value: float,
+        out_interp: Optional[FittingFunctionType] = None,
+        in_tangent: Optional[Tuple[float, float]] = None,
+        out_tangent: Optional[Tuple[float, float]] = None,
+        use_bezier: bool = False,
+    ):
+        """
+        添加或更新关键帧。
+
+        Parameters
+        ----------
+        time : float
+            关键帧时间。
+        value : float
+            参数值。
+        out_interp : Optional[Callable]
+            出插值函数（若 use_bezier=False）。
+        in_tangent : Optional[Tuple[float, float]]
+            入切线偏移 (dt, dv)。dt 通常为负（表示左侧），但存储为绝对偏移。
+        out_tangent : Optional[Tuple[float, float]]
+            出切线偏移 (dt, dv)。dt 通常为正。
+        use_bezier : bool
+            是否使用贝塞尔插值。
+
+        Returns
+        -------
+        None
+
+        Notes
+        -----
+        若时间已存在，更新该关键帧的所有属性。
+        """
+        interp = (
+            out_interp if out_interp is not None else self.base_interpolation_function
+        )
+        new_key = Keyframe(time, value, interp, in_tangent, out_tangent, use_bezier)
+
+        idx = bisect.bisect_left(self._keys, time, key=lambda k: k.time)
+        if idx < len(self._keys) and self._keys[idx].time == time:
+            self._keys[idx] = new_key
+        else:
+            self._keys.insert(idx, new_key)
+
+    def remove_key(self, time: float):
+        """
+        移除指定时间的关键帧。
+
+        Parameters
+        ----------
+        time : float
+            要移除的关键帧时间。
+
+        Returns
+        -------
+        None
+        """
+        idx = bisect.bisect_left(self._keys, time, key=lambda k: k.time)
+        if idx < len(self._keys) and self._keys[idx].time == time:
+            del self._keys[idx]
+
+    def update_key_value(self, time: float, new_value: float):
+        """更新关键帧值，保留其他属性。"""
+        idx = bisect.bisect_left(self._keys, time, key=lambda k: k.time)
+        if idx < len(self._keys) and self._keys[idx].time == time:
+            k = self._keys[idx]
+            self._keys[idx] = Keyframe(
+                time, new_value, k.out_interp, k.in_tangent, k.out_tangent, k.use_bezier
+            )
+
+    def update_key_interp(
+        self,
+        time: float,
+        out_interp: Optional[FittingFunctionType] = None,
+        in_tangent: Optional[Tuple[float, float]] = None,
+        out_tangent: Optional[Tuple[float, float]] = None,
+        use_bezier: bool = False,
+    ):
+        """更新关键帧的插值属性。"""
+        idx = bisect.bisect_left(self._keys, time, key=lambda k: k.time)
+        if idx < len(self._keys) and self._keys[idx].time == time:
+            k = self._keys[idx]
+            new_value = k.value
+            interp = out_interp if out_interp is not None else k.out_interp
+            self._keys[idx] = Keyframe(
+                time, new_value, interp, in_tangent, out_tangent, use_bezier
+            )
+
+    def set_key_tangents(
+        self,
+        time: float,
+        in_tangent: Optional[Tuple[float, float]] = None,
+        out_tangent: Optional[Tuple[float, float]] = None,
+        use_bezier: bool = True,
+    ):
+        """单独设置关键帧的切线，不改变值。"""
+        idx = bisect.bisect_left(self._keys, time, key=lambda k: k.time)
+        if idx < len(self._keys) and self._keys[idx].time == time:
+            k = self._keys[idx]
+            self._keys[idx] = Keyframe(
+                time,
+                k.value,
+                out_interp=k.out_interp,
+                in_tangent=in_tangent,
+                out_tangent=out_tangent,
+                use_bezier=use_bezier,
+            )
+
+    def make_key_smooth(self, time: float):
+        """
+        将关键帧设为“平滑”模式（自动对称切线，并设为贝塞尔模式）。
+        切线长度基于相邻关键帧的时间和值差。
+        """
+        idx = bisect.bisect_left(self._keys, time, key=lambda k: k.time)
+        if idx < len(self._keys) and self._keys[idx].time == time:
+            k = self._keys[idx]
+            prev_k = self._keys[idx - 1] if idx > 0 else None
+            next_k = self._keys[idx + 1] if idx + 1 < len(self._keys) else None
+
+            # 默认切线长度：时间差的 1/3，值差按比例
+            dt_in = dt_out = 0.1
+            dv_in = dv_out = 0.0
+
+            if prev_k and next_k:
+                dt_total = next_k.time - prev_k.time
+                dv_total = next_k.value - prev_k.value
+                dt_in = dt_out = dt_total / 3.0
+                dv_in = dv_out = dv_total / 3.0
+            elif prev_k:
+                dt_out = (k.time - prev_k.time) / 2.0
+                dv_out = (k.value - prev_k.value) / 2.0
+                dt_in = dt_out
+                dv_in = dv_out
+            elif next_k:
+                dt_in = (next_k.time - k.time) / 2.0
+                dv_in = (next_k.value - k.value) / 2.0
+                dt_out = dt_in
+                dv_out = dv_in
+
+            self.set_key_tangents(
+                time,
+                in_tangent=(-dt_in, -dv_in),  # in_tangent 存储为偏移，使用时做减法
+                out_tangent=(dt_out, dv_out),
+                use_bezier=True,
+            )
+
+    def _get_boundary_value(self, t: float) -> float:
+        """根据 boundary_mode 获取范围外的值。"""
+        if not self._keys:
+            return self.base_line
+        if self.boundary_behaviour == BoundaryBehaviour.CONSTANT:
+            return self.base_line
+        elif self.boundary_behaviour == BoundaryBehaviour.HOLD:
+            if t < self._keys[0].time:
+                return self._keys[0].value
+            else:
+                return self._keys[-1].value
+        else:  # 可能会有别的模式吗？
+            return self.base_line
+
+    def value_at(self, t: float) -> float:
+        """
+        计算时间 t 处的曲线值。
+
+        Parameters
+        ----------
+        t : float
+            查询时间。
+
+        Returns
+        -------
+        float
+            插值结果。
+        """
+        keys = self._keys
+        if not keys:
+            return self._get_boundary_value(t)
+
+        if t < keys[0].time or t > keys[-1].time:
+            return self._get_boundary_value(t)
+
+        times = [k.time for k in keys]
+        idx = bisect.bisect_right(times, t) - 1
+
+        if idx < 0:
+            return self._get_boundary_value(t)
+        if idx >= len(keys) - 1:
+            return keys[-1].value
+
+        k0 = keys[idx]
+        k1 = keys[idx + 1]
+
+        if k0.time == k1.time:
+            return k0.value
+        if k0.time == t:
+            return k0.value
+        if k1.time == t:
+            return k1.value
+
+        t0, v0 = k0.time, k0.value
+        t1, v1 = k1.time, k1.value
+        u = (t - t0) / (t1 - t0)
+        u = max(0.0, min(1.0, u))
+
+        # 贝塞尔模式（高优先级）
+        if k0.use_bezier or k1.use_bezier:
+            return _evaluate_bezier_segment(
+                t0,
+                v0,
+                t1,
+                v1,
+                out_tangent=k0.out_tangent,
+                in_tangent=k1.in_tangent,  # ← 关键：使用下一帧的 in_tangent！
+                u=u,
+            )
+
+        # 函数插值模式，优先处理阶梯保持模式
+        elif k0.out_interp is InterpolationMethod.hold:
+            return v0
+
+        interp_func = k0.out_interp or self.base_interpolation_function
+        v_norm = interp_func(u)
+        return v0 + v_norm * (v1 - v0)
+
+    def __call__(self, t: float) -> float:
+        return self.value_at(t)
+
+    def get_all_keys(self) -> List[Tuple[float, float]]:
+        """返回 (time, value) 列表。"""
+        return [(k.time, k.value) for k in self._keys]
+
+    def set_default_interpolation_function(self, interp_func: FittingFunctionType):
+        """设置默认插值函数。"""
+        self.base_interpolation_function = interp_func
+
+    def set_boundary_mode(
+        self, mode: BoundaryBehaviour, base_value: Optional[float] = None
+    ):
+        """
+        设置边界行为。
+
+        Parameters
+        ----------
+        mode : BoundaryBehaviour
+            边界行为设定
+        base_value : Optional[float]
+            当 mode=BoundaryBehaviour.CONSTANT 时，指定新的默认值。
+        """
+        self.boundary_behaviour = mode
+        if base_value is not None:
+            self.base_line = base_value
+
+    def bake(
+        self,
+        start: float,
+        end: float,
+        sample_rate: Optional[float] = None,
+        num_samples: Optional[int] = None,
+        dtype: Any = None,
+    ) -> "np.ndarray":  # type: ignore 这里这样用会报错吗？不知道，但是人工智能这样写了都，大抵是能用的吧
+        """
+        将参数曲线在指定时间范围内烘焙为 NumPy 数组，用于高性能实时查询或音频渲染。
+
+        Parameters
+        ----------
+        start : float
+            烘焙起始时间（包含）。
+        end : float
+            烘焙结束时间（不包含）。
+        sample_rate : Optional[float]
+            采样率（单位：样本/时间单位）。例如，若时间单位为秒，sample_rate=48000 表示每秒 48k 样本。
+            必须与 `num_samples` 二选一提供。
+        num_samples : Optional[int]
+            输出数组的总样本数。若提供，则忽略 `sample_rate`。
+        dtype : Any, optional
+            输出数组的数据类型（如 np.float32）。默认为 np.float64。
+
+        Returns
+        -------
+        np.ndarray
+            一维 NumPy 数组，长度为 `num_samples`，`arr[i] ≈ curve(start + i / sample_rate)`。
+
+        Exceptions
+        ----------
+        ValueError
+            - 若 `start >= end`
+            - 若未提供 `sample_rate` 且未提供 `num_samples`
+            - 若 `num_samples <= 0`
+
+        Notes
+        -----
+        - 内部使用 `np.linspace` 生成时间轴，然后逐点调用 `self.value_at(t)`。
+        - 虽然目前是 Python 循环，但对于典型自动化曲线（<1000 关键帧），NumPy 向量化优势主要体现在内存布局和后续处理。
+        - 如需极致性能（如 >1M 样本），可未来优化为 C++/Numba 加速，但当前已满足 DAW 自动化需求。
+        """
+        if start >= end:
+            raise ValueError("起始值须小于结束值。")
+
+        if num_samples is not None:
+            if num_samples <= 0:
+                raise ValueError("烘焙的采样数须为非零自然数。")
+            n = num_samples
+        elif sample_rate is not None:
+            if sample_rate <= 0:
+                raise ValueError("烘焙的采样率须为正值。")
+            duration = end - start
+            n = int(ceil(duration * sample_rate))
+            # 别因为小数数值会产生的问题而越界了来着
+            if n == 0:
+                n = 1
+        else:
+            raise ValueError("烘焙参数时，须提供采样率或采样数。")
+
+        import numpy as np
+
+        # 生成对应时间的节点：[start, ..., end - dt]
+        times = np.linspace(start, end, n, endpoint=False)
+
+        # 计算每个时间节点上的参数值
+        # 我们认为在数字音频工作站的环境里，此值可能最多到 ~1e6 的样子，因此这样 for 一下应当可以接受
+        # WARNING: 人工智能是这样理解的，如果有问题的话后续可能需要更改
+        values = np.empty(n, dtype=dtype or np.float64)
+        for i in range(n):
+            values[i] = self.value_at(float(times[i]))
+
+        return values

Musicreater/plugins.py

@@ -0,0 +1,424 @@
+# -*- coding: utf-8 -*-
+
+"""
+存储 音·创 v3 的插件接口与管理相关内容
+"""
+
+"""
+版权所有 © 2026 金羿
+Copyright © 2026 Eilles
+
+开源相关声明请见 仓库根目录下的 License.md
+Terms & Conditions: License.md in the root directory
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+
+import importlib
+from pathlib import Path
+from typing import (
+    Dict,
+    Any,
+    Optional,
+    List,
+    Tuple,
+    Union,
+    Generator,
+    Set,
+    Iterable,
+    Iterator,
+    TypeVar,
+    Mapping,
+    Callable,
+)
+from itertools import chain
+
+
+from ._plugin_abc import (
+    # 枚举类
+    PluginTypes,
+    # 抽象基类/数据类（插件参数定义）
+    PluginConfig,
+    PluginMetaInformation,
+    # 抽象基类（插件定义）
+    MusicInputPluginBase,
+    TrackInputPluginBase,
+    MusicOperatePluginBase,
+    TrackOperatePluginBase,
+    MusicOutputPluginBase,
+    TrackOutputPluginBase,
+    ServicePluginBase,
+    LibraryPluginBase,
+    # 顶层插件定义
+    TopPluginBase,
+)
+from .exceptions import (
+    PluginMetainfoNotFoundError,
+    ParameterTypeError,
+    PluginInstanceNotFoundError,
+    PluginRegisteredError,
+)
+
+
+__all__ = [
+    # 枚举类
+    "PluginTypes",
+    # 抽象基类/数据类（插件参数定义）
+    "PluginConfig",
+    "PluginMetaInformation",
+    # 抽象基类（插件定义）
+    "MusicInputPluginBase",
+    "TrackInputPluginBase",
+    "MusicOperatePluginBase",
+    "TrackOperatePluginBase",
+    "MusicOutputPluginBase",
+    "TrackOutputPluginBase",
+    "ServicePluginBase",
+    "LibraryPluginBase",
+    # 插件注册用装饰函数
+    "music_input_plugin",
+    "track_input_plugin",
+    "music_operate_plugin",
+    "track_operate_plugin",
+    "music_output_plugin",
+    "track_output_plugin",
+    "service_plugin",
+    "library_plugin",
+]
+
+
+T_IOPlugin = TypeVar(
+    "T_IOPlugin",
+    MusicInputPluginBase,
+    TrackInputPluginBase,
+    MusicOutputPluginBase,
+    TrackOutputPluginBase,
+)
+T_Plugin = TypeVar(
+    "T_Plugin",
+    MusicInputPluginBase,
+    TrackInputPluginBase,
+    MusicOperatePluginBase,
+    TrackOperatePluginBase,
+    MusicOutputPluginBase,
+    TrackOutputPluginBase,
+    ServicePluginBase,
+    LibraryPluginBase,
+)
+
+
+def load_plugin_module(package: Union[Path, str]):
+    """自动发现并加载插件包中的插件
+
+    参数:
+    =====
+    package: Path | str, 可选
+        插件包路径或名称，当为 Path 类时为路径，为 str 时为包名，切勿混淆。
+    """
+
+    if isinstance(package, Path):
+        relative_path = package.resolve().relative_to(Path.cwd().resolve())
+        if relative_path.stem == "__init__":
+            return importlib.import_module(".".join(relative_path.parts[:-1]))
+        else:
+            return importlib.import_module(
+                ".".join(relative_path.parts[:-1] + (relative_path.stem,))
+            )
+    else:
+        return importlib.import_module(package)
+
+
+class PluginRegistry:
+    """插件注册管理器（注册表）"""
+
+    def __init__(self):
+        self._music_input_plugins: Dict[str, MusicInputPluginBase] = {}
+        self._track_input_plugins: Dict[str, TrackInputPluginBase] = {}
+        self._music_operate_plugins: Dict[str, MusicOperatePluginBase] = {}
+        self._track_operate_plugins: Dict[str, TrackOperatePluginBase] = {}
+        self._music_output_plugins: Dict[str, MusicOutputPluginBase] = {}
+        self._track_output_plugins: Dict[str, TrackOutputPluginBase] = {}
+        self._service_plugins: Dict[str, ServicePluginBase] = {}
+        self._library_plugins: Dict[str, LibraryPluginBase] = {}
+
+    def __iter__(self) -> Iterator[Tuple[PluginTypes, Mapping[str, TopPluginBase]]]:
+        """迭代器，返回所有插件"""
+        return iter(
+            (
+                (PluginTypes.FUNCTION_MUSIC_IMPORT, self._music_input_plugins),
+                (PluginTypes.FUNCTION_TRACK_IMPORT, self._track_input_plugins),
+                (PluginTypes.FUNCTION_MUSIC_OPERATE, self._music_operate_plugins),
+                (PluginTypes.FUNCTION_TRACK_OPERATE, self._track_operate_plugins),
+                (PluginTypes.FUNCTION_MUSIC_EXPORT, self._music_output_plugins),
+                (PluginTypes.FUNCTION_TRACK_EXPORT, self._track_output_plugins),
+                (PluginTypes.SERVICE, self._service_plugins),
+                (PluginTypes.LIBRARY, self._library_plugins),
+            )
+        )
+
+    @staticmethod
+    def _register_plugin(cls_dict: dict, plg_class: type, plg_id: str) -> None:
+        """注册插件"""
+        if plg_id in cls_dict:
+            if cls_dict[plg_id].metainfo.version >= plg_class.metainfo.version:
+                raise PluginRegisteredError(
+                    "插件惟一识别码`{}`所对应的插件已存在更高版本`{}`，请勿重复注册同一插件！".format(
+                        plg_id, plg_class.metainfo
+                    )
+                )
+        cls_dict[plg_id] = plg_class()
+
+    def register_music_input_plugin(
+        self,
+        plugin_class: type,
+        plugin_id: str,
+    ) -> None:
+        """注册输入插件-整首曲目"""
+        self._register_plugin(self._music_input_plugins, plugin_class, plugin_id)
+
+    def register_track_input_plugin(self, plugin_class: type, plugin_id: str) -> None:
+        """注册输入插件-单个音轨"""
+        self._register_plugin(self._track_input_plugins, plugin_class, plugin_id)
+
+    def register_music_operate_plugin(self, plugin_class: type, plugin_id: str) -> None:
+        """注册曲目处理插件"""
+        self._register_plugin(self._music_operate_plugins, plugin_class, plugin_id)
+
+    def register_track_operate_plugin(self, plugin_class: type, plugin_id: str) -> None:
+        """注册音轨处理插件"""
+        self._register_plugin(self._track_operate_plugins, plugin_class, plugin_id)
+
+    def register_music_output_plugin(self, plugin_class: type, plugin_id: str) -> None:
+        """注册输出插件-整首曲目"""
+        self._register_plugin(self._music_output_plugins, plugin_class, plugin_id)
+
+    def register_track_output_plugin(self, plugin_class: type, plugin_id: str) -> None:
+        """注册输出插件-单个音轨"""
+        self._register_plugin(self._track_output_plugins, plugin_class, plugin_id)
+
+    def register_service_plugin(self, plugin_class: type, plugin_id: str) -> None:
+        """注册服务插件"""
+        self._register_plugin(self._service_plugins, plugin_class, plugin_id)
+
+    def register_library_plugin(self, plugin_class: type, plugin_id: str) -> None:
+        """注册支持库插件"""
+        self._register_plugin(self._library_plugins, plugin_class, plugin_id)
+
+    @staticmethod
+    def _get_io_plugin_by_format(
+        plugin_regdict: Dict[str, T_IOPlugin], fpath_or_format: Union[Path, str]
+    ) -> Generator[T_IOPlugin, None, None]:
+        if isinstance(fpath_or_format, str):
+            return (
+                plugin
+                for plugin in plugin_regdict.values()
+                if plugin.can_handle_format(fpath_or_format)
+            )
+        elif isinstance(fpath_or_format, Path):
+            return (
+                plugin
+                for plugin in plugin_regdict.values()
+                if plugin.can_handle_file(fpath_or_format)
+            )
+        else:
+            raise ParameterTypeError(
+                "用于指定“导入全曲的数据之类型”的参数，其类型须为`Path`路径或字符串，而非`{}`类型的`{}`值".format(
+                    type(fpath_or_format), fpath_or_format
+                )
+            )
+
+    def get_music_input_plugin_by_format(
+        self, filepath_or_format: Union[Path, str]
+    ) -> Generator[MusicInputPluginBase, None, None]:
+        """通过指定输入的文件或格式，以获取对应的全曲导入用插件"""
+        return self._get_io_plugin_by_format(
+            self._music_input_plugins, filepath_or_format
+        )
+
+    def get_track_input_plugin_by_format(
+        self, filepath_or_format: Union[Path, str]
+    ) -> Generator[TrackInputPluginBase, None, None]:
+        """通过指定输入的文件或格式，以获取对应的单音轨导入用插件"""
+        return self._get_io_plugin_by_format(
+            self._track_input_plugins, filepath_or_format
+        )
+
+    def get_music_output_plugin_by_format(
+        self, filepath_or_format: Union[Path, str]
+    ) -> Generator[MusicOutputPluginBase, None, None]:
+        """通过指定输出的文件或格式，以获取对应的导出全曲用插件"""
+        return self._get_io_plugin_by_format(
+            self._music_output_plugins, filepath_or_format
+        )
+
+    def get_track_output_plugin_by_format(
+        self, filepath_or_format: Union[Path, str]
+    ) -> Generator[TrackOutputPluginBase, None, None]:
+        """通过指定输出的文件或格式，以获取对应的导出单个音轨用插件"""
+        return self._get_io_plugin_by_format(
+            self._track_output_plugins, filepath_or_format
+        )
+
+    def _get_plugin_by_name(
+        self,
+        plugin_regdict: Mapping[str, T_Plugin],
+        plugin_name: str,
+        plugin_usage: str = "",
+    ) -> T_Plugin:
+        """通过指定名称，以获取对应的插件，当名称重叠时，取版本号最大的"""
+        try:
+            return max(
+                [
+                    plugin
+                    for plugin in plugin_regdict.values()
+                    if plugin.metainfo.name == plugin_name
+                ],
+                key=lambda plugin: plugin.metainfo.version,
+            )
+        except ValueError:
+            raise PluginInstanceNotFoundError(
+                "未找到“用于{}、名为`{}`”的插件".format(plugin_usage, plugin_name)
+            )
+
+    def get_music_input_plugin(self, plugin_name: str) -> MusicInputPluginBase:
+        """获取指定名称的全曲导入用插件，当名称重叠时，取版本号最大的"""
+        return self._get_plugin_by_name(
+            self._music_input_plugins, plugin_name, "导入全曲"
+        )
+
+    def get_track_input_plugin(self, plugin_name: str) -> TrackInputPluginBase:
+        """获取指定名称的单音轨导入用插件，当名称重叠时，取版本号最大的"""
+        return self._get_plugin_by_name(
+            self._track_input_plugins, plugin_name, "导入单轨"
+        )
+
+    def get_music_operate_plugin(self, plugin_name: str) -> MusicOperatePluginBase:
+        """获取指定名称的全曲处理用插件，当名称重叠时，取版本号最大的"""
+        return self._get_plugin_by_name(
+            self._music_operate_plugins, plugin_name, "处理整个曲目"
+        )
+
+    def get_track_operate_plugin(self, plugin_name: str) -> TrackOperatePluginBase:
+        """获取指定名称的单音轨处理用插件，当名称重叠时，取版本号最大的"""
+        return self._get_plugin_by_name(
+            self._track_operate_plugins, plugin_name, "处理单个音轨"
+        )
+
+    def get_music_output_plugin(self, plugin_name: str) -> MusicOutputPluginBase:
+        """获取指定名称的导出全曲用插件，当名称重叠时，取版本号最大的"""
+        return self._get_plugin_by_name(
+            self._music_output_plugins, plugin_name, "导出完整曲目"
+        )
+
+    def get_track_output_plugin(self, plugin_name: str) -> TrackOutputPluginBase:
+        """获取指定名称的导出单音轨用插件，当名称重叠时，取版本号最大的"""
+        return self._get_plugin_by_name(
+            self._track_output_plugins, plugin_name, "导出单个音轨"
+        )
+
+    def get_service_plugin(self, plugin_name: str) -> ServicePluginBase:
+        """获取服务用插件，当名称重叠时，取版本号最大的"""
+        return self._get_plugin_by_name(self._service_plugins, plugin_name, "提供服务")
+
+    def get_library_plugin(self, plugin_name: str) -> LibraryPluginBase:
+        """获取依赖库类插件，当名称重叠时，取版本号最高的"""
+        return self._get_plugin_by_name(
+            self._library_plugins, plugin_name, "作为依赖库"
+        )
+
+    def supported_input_formats(self) -> Set[str]:
+        """所有支持的导入格式"""
+        return set(
+            chain.from_iterable(
+                plugin.supported_formats
+                for plugin in chain(
+                    self._music_input_plugins.values(),
+                    self._track_input_plugins.values(),
+                )
+            )
+        )
+
+    def supported_output_formats(self) -> Set[str]:
+        """所有支持的导出格式"""
+        return set(
+            chain.from_iterable(
+                plugin.supported_formats
+                for plugin in chain(
+                    self._music_output_plugins.values(),
+                    self._track_output_plugins.values(),
+                )
+            )
+        )
+
+
+_global_plugin_registry = PluginRegistry()
+"""全局插件注册表实例"""
+
+
+def __plugin_regist_decorator(plg_id: str, rgst_func: Callable[[type, str], None]):
+
+    def decorator(cls):
+        global _global_plugin_registry
+        cls.id = plg_id
+        rgst_func(cls, plg_id)
+        return cls
+
+    return decorator
+
+
+def music_input_plugin(plugin_id: str):
+    """全曲输入用插件装饰器"""
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_music_input_plugin
+    )
+
+
+def track_input_plugin(plugin_id: str):
+    """单轨输入用插件装饰器"""
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_track_input_plugin
+    )
+
+
+def music_operate_plugin(plugin_id: str):
+    """全曲处理用插件装饰器"""
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_music_operate_plugin
+    )
+
+def track_operate_plugin(plugin_id: str):
+    """音轨处理插件装饰器"""
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_track_operate_plugin
+    )
+
+
+def music_output_plugin(plugin_id: str):
+    """乐曲输出用插件装饰器"""
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_music_output_plugin
+    )
+
+
+def track_output_plugin(plugin_id: str):
+    """音轨输出用插件装饰器"""
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_track_output_plugin
+    )
+
+
+def service_plugin(plugin_id: str):
+    """服务插件装饰器"""
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_service_plugin
+    )
+
+def library_plugin(plugin_id: str):
+    """支持库插件装饰器"""
+
+    return __plugin_regist_decorator(
+        plugin_id, _global_plugin_registry.register_library_plugin
+    )

Musicreater/types.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+
+"""
+存储 音·创 v3 定义的一些数据类型，可以用于类型检查器
+"""
+
+"""
+版权所有 © 2026 金羿 & 玉衡Alioth
+Copyright © 2026 Eilles & YuhengAlioth
+
+开源相关声明请见 仓库根目录下的 License.md
+Terms & Conditions: License.md in the root directory
+"""
+
+# 睿乐组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+
+from typing import Callable, Dict, List, Literal, Mapping, Tuple, Union
+
+FittingFunctionType = Callable[[float], float]
+"""
+拟合函数类型
+"""

README.md

@@ -1,104 +1,136 @@
-# 音·创 Musicreater
+[Bilibili: 金羿ELS]: https://img.shields.io/badge/Bilibili-%E9%87%91%E7%BE%BFELS-00A1E7?style=for-the-badge
+[Bilibili: 玉衡Alioth]: https://img.shields.io/badge/Bilibili-%E7%8E%89%E8%A1%A1Alioth-00A1E7?style=for-the-badge
+[CodeStyle: black]: https://img.shields.io/badge/code%20style-black-121110.svg?style=for-the-badge
+[python]: https://img.shields.io/badge/python-3.8-AB70FF?style=for-the-badge
+[release]: https://img.shields.io/github/v/release/EillesWan/Musicreater?style=for-the-badge
+[license]: https://img.shields.io/badge/Licence-%E6%B1%89%E9%92%B0%E5%BE%8B%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE-228B22?style=for-the-badge
 
-### 介绍
-音·创 Musicreater 是由金羿(*W-YI*)开发的一款 **《我的世界：基岩版》** 音乐生成辅助软件
+<h1 align="center">音·创 Musicreater </h1>
 
-欢迎加群：861684859
+<p align="center">
+    <img width="128" height="128" src="https://gitee.com/TriM-Organization/Musicreater/raw/master/resources/msctIcon.png">
+    </img>
+</p>
 
-### 作者
+<h3 align="center">一款免费开源的《我的世界》数字音频支持库。</h3>
 
-金羿 (Eilles)：主要作者，开发了音·创主体，及其前身“函数音乐生成器”、“世界音创”。
+<p align="center">
+    <img src="https://img.shields.io/badge/BUILD%20WITH%20LOVE-FF3432?style=for-the-badge">
+    <a href='https://gitee.com/TriM-Organization/Musicreater'>
+        <img align="right" src='https://gitee.com/TriM-Organization/Musicreater/widgets/widget_1.svg' alt='Fork me on Gitee'>
+        </img>
+    </a>
+<p>
 
-bgArray “诸葛亮与八卦阵”：修复bug，改进代码美观度，增加新功能，更改数据格式等。
+[![][Bilibili: 金羿ELS]](https://space.bilibili.com/397369002/)
+[![][Bilibili: 玉衡Alioth]](https://space.bilibili.com/604072474)
+[![CodeStyle: black]](https://github.com/psf/black)
+[![][python]](https://www.python.org/)
+[![][license]](LICENSE)
+[![][release]](../../releases)
 
-### 软件架构
+[![GiteeStar](https://gitee.com/TriM-Organization/Musicreater/badge/star.svg?theme=gray)](https://gitee.com/TriM-Organization/Musicreater/stargazers)
+[![GiteeFork](https://gitee.com/TriM-Organization/Musicreater/badge/fork.svg?theme=gray)](https://gitee.com/TriM-Organization/Musicreater/members)
+[![GitHub Repo stars](https://img.shields.io/github/stars/TriM-Organization/Musicreater?color=white&logo=GitHub&style=plastic)](https://github.com/TriM-Organization/Musicreater/stargazers)
+[![GitHub Repo Forks](https://img.shields.io/github/forks/TriM-Organization/Musicreater?color=white&logo=GitHub&style=plastic)](https://github.com/TriM-Organization/Musicreater/forks)
 
-软件采用 *Python* 作为第一语言，目前还没有使用其他语言辅助。使用 *Tkinter* 为图形库。
+简体中文🇨🇳 | [English🇬🇧](README_EN.md)
 
-支持 Windows7+ 以及各个支持 Python3.8 的 Linux
+## 介绍 🚀
 
-***各位开发人员注意！！！多语言支持请使用`READABLETEXT`常量输出文字！！！如需补充，请在简体中文的语言文件(zhCN.py)中补充！！！***
+音·创 是一款免费开源的针对 **《我的世界》** 音乐的支持库
+
+欢迎加群：[861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)
+
+> **注意** 本仓库内的项目仅仅是支持库，其用户为基岩版音乐相关软件的开发者
+>
+> 面向常规用户的 **基岩版音乐转换工具** 请参阅：[伶伦转换器](../../../Linglun-Converter)
+>
+> 我们也正在开发面向高级用户的 **基岩版音乐编辑工具**（数字音频工作站）：[伶伦](../../../LinglunStudio)
 
 
-### 安装教程
+## 安装 🔳
 
-正在到来。
+-   使用 pypi
 
-### 从源代码运行教程
+    ```bash
+    pip install --upgrade Musicreater
+    ```
 
-#### Windows7+
+-   如果无法更新最新，可以尝试：
 
-0.  [Gitee下载（需要登陆）](https://gitee.com/EillesWan/Musicreater/repository/archive/master.zip)
-    [Github下载（慢）](https://github.com/EillesWan/Musicreater/archive/refs/heads/master.zip)本程序源代码
-1.  安装Python 3.8.10 
-    [下载64位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe)
-    [下载32位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10.exe)
-2.  以管理员身份运行 补全库.py :
-    -   点击 “开始” 菜单，搜索 `命令提示符`
-    -   右键点击 `命令提示符` 左键点击 “以管理员身份运行”
-    -   将 “补全库.py” 拖拽入开启的窗口，按下回车
-3.  等待安装完成后，双击运行 Musicreater.py
+    ```bash
+    pip install --upgrade -i https://pypi.python.org/simple Musicreater
+    ```
 
-#### Linux
+-   克隆仓库并安装（最新内容但**不推荐**）
 
-0.  若你没有足够优秀的环境，推荐先在终端敲：
-```bash
-sudo apt-get update
-sudo apt-get upgrade
-sudo apt-get install python3
-sudo apt-get install python3-pip
-sudo apt-get install git
-```
-1.  若你足够自信，该整的都整了，就在你想下载此程序的地方打开终端，敲：
-```bash
-sudo git clone https://gitee.com/EillesWan/Musicreater.git
-cd Musicreater
-python3 补全库.py
-python3 Musicreater.py
-```
+    ```bash
+    git clone https://gitee.com/TriM-Organization/Musicreater.git
+    cd Musicreater
+    python setup.py install
+    ```
 
+以上命令中 `python`、`pip` 请依照各个环境不同灵活更换，可能为`python3`或`pip3`之类。
 
-### 使用说明
+## 文档 📄
 
-1.  直接运行就好
-2.  看得懂简体中文字的不一定全会用
-3.  最好要懂一点点英文
+[生成文件的使用](./docs/%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)
 
+[仓库 API 文档](./docs/%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md)
 
-### 诸葛亮与八卦阵的说明（不必要）
+## 作者 ✒
 
-1. 首先！这里的提示是给想使用多音色资源包的人的，如果你想用就请下载 [神羽资源包（神羽自己的链接）](https://pan.baidu.com/s/11uoq5zwN7c3rX-98DqVpJg)提取码:ek3t
-2. 下载到你自己电脑上某个位置，可以不放置于本项目下。音色资源包较大，可以选取只下载：
-    `神羽资源包_乐器、音源的资源包\羽音缭绕-midiout_25.0` 这个文件夹，再嫌麻烦的话，也可以只下载其中的：
-    `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\mcpack(国际版推荐)格式_25.0` 或者：
-    `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\zip格式_25.0`
-4. 接下来就是关键了：在*音创*中绑定资源包
-    首先，先打开 *音创*->帮助与疑问->\[神羽资源包位置选择\]：选择文件夹... 这时候，会跳出选择框
-    关键来了，选择：***您下载的`羽音缭绕-midiout_25.0`文件夹，或者`mcpack(国际版推荐)格式_25.0`或`zip格式_25.0`的上级目录***
-    举个例子：我的文件路径是这样的：
-    `L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0`这里面有：`神羽资源包_25.0_使用方法.xls`、
-    `mcpack(国际版推荐)格式_25.0`、`zip格式_25.0`两个文件夹和一个.xls文件，而你在音创中
-    也应该选择这个文件夹：**L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0**
-6. 如果你想使用音色资源包来制作函数，那么解析时你应该用 *音创*->编辑->从midi导入音轨且用新方法解析，
-    然后再使用 *音创*->函数（包）->下面的四个新函数
+**金羿 Eilles**：我的世界基岩版指令作者，个人开发者，B 站不知名 UP 主。
 
-### 致谢
+**玉衡Alioth Alioth**：我的世界基岩版玩家，喜欢编程和音乐，学生。
 
-1.  感谢由 [Fuckcraft](https://github.com/fuckcraft) “鸣凤鸽子”等 带来的我的世界websocket服务器功能
-2.  感谢 昀梦\<QQ1515399885\> 找出指令生成错误bug并指正
-3.  感谢由 Charlie_Ping “查理平” 带来的bdx转换功能
-4.  感谢由 CMA_2401PT 带来的 BDXWorkShop 供本程序对于bdx操作的指导
-5.  感谢由 Miracle Plume “神羽” \<QQshenyu40403\>带来的羽音缭绕基岩版音色资源包
-6.  感谢广大群友为此程序提供的测试等支持
-7.  若您对我们有所贡献但您的名字没有显示在此列表中，请联系我！
+**偷吃不是Touch Touch**：我的世界基岩版指令制作者，提供测试支持
 
+## 致谢 🙏
 
-### 作者\<*金羿*\>(W-YI)联系方式
+本致谢列表排名无顺序。
 
-1.  QQ       2647547478
-2.  电邮      EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
-3.  微信      WYI_DoctorYI
+-   感谢 **昀梦**\<QQ1515399885\> 找出指令生成错误 bug 并指正
+-   感谢由 **Charlie_Ping “查理平”** 带来的 BDX 文件转换参考，以及 MIDI-我的世界对应乐器 参考表格
+-   感谢由 **[CMA_2401PT](https://github.com/CMA2401PT)** 为我们的软件开发的一些方面进行指导，同时我们参考了他的 BDXworkshop 作为 BDX 结构编辑的参考
+-   感谢由 **[Dislink Sforza](https://github.com/Dislink) “断联·斯福尔扎”**\<QQ1600515314\> 带来的 midi 音色解析以及转换指令的算法，我们将其改编并应用；同时，感谢他的[网页版转换器](https://dislink.github.io/midi2bdx/)给我们的开发与更新带来巨大的压力和动力，让我们在原本一骑绝尘的摸鱼道路上转向开发。
+-   感谢 **Mono**\<QQ738893087\> 反馈安装时的问题，辅助我们找到了视窗操作系统下的兼容性问题；感谢其反馈延迟播放器出现的重大问题，让我们得以修改全部延迟播放错误；尤其感谢他对于我们的软件的大力宣传
+-   感谢 **Ammelia “艾米利亚”**\<QQ2838334637\> 敦促我们进行新的功能开发，并为新功能提出了非常优秀的大量建议，以及提供的 BDX 导入测试支持，为我们的新结构生成算法提供了大量的实际理论支持
+-   感谢 **[神羽 “SnowyKami”](https://www.sfkm.me/)** 对我们项目的支持与宣传，非常感谢他为我们提供的服务器！
+-   感谢 **指令师\_苦力怕 playjuice123**\<QQ240667197\> 为我们的程序找出错误，并提醒我们修复一个一直存在的大 bug。
+-   感谢 **雷霆**\<QQ3555268519\> 用他那令所有开发者都大为光火的操作方法为我们的程序找出错误，并提醒修复 bug。
+-   感谢 **小埋**\<QQ2039310975\> 反馈附加包生成时缺少描述和标题的问题。
+-   <table><tr><td>感谢 **油炸**&lt;QQ2836146704&gt;  激励我们不断开发新的内容。</td><td><img height="50" src="https://foruda.gitee.com/images/1695478907647543027/08ea9909_9911226.jpeg"></td></tr></table>
+-   感谢 **雨**\<QQ237667809\> 反馈在新版本的指令格式下，计分板播放器的附加包无法播放的问题。
+-   感谢 **梦幻duang**\<QQ13753593\> 为我们提供 Java 1.12.2 版本命令格式参考。
+-   感谢 [_Open Note Block Studio_](https://github.com/OpenNBS/NoteBlockStudio) 项目的开发为我们提供持续的追赶动力。
 
-### 作者\<*诸葛亮与八卦阵*\>(bgArray) 联系方式
+>     感谢广大群友为此库提供的测试和建议等
+>     若您对我们有所贡献但您的名字没有出现在此列表中，请联系我们！
 
-1.  QQ       4740437765
+## 联系 📞
+
+若遇到库中的问题，欢迎在[此](https://gitee.com/TriM-Organization/Musicreater/issues/new)提出你的 issue。
+
+如果需要与开发组进行交流，欢迎加入我们的[开发闲聊 Q 群](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)。
+
+亦可以联系我们[睿乐组织官方邮箱](mailto:TriM-Organization@hotmail.com)，取得进一步联系！
+
+---
+
+此项目并非一个官方 《我的世界》（_Minecraft_）项目
+
+此项目不隶属或关联于 Mojang Studios 或 微软
+
+此项目亦不隶属或关联于 网易
+
+“Minecraft”是 Mojang Synergies AB 的商标，此项目中所有对于“我的世界”、“Minecraft”等相关称呼均为必要的介绍性使用
+
+-   上文提及的 网易 公司，指代的是在中国大陆运营《我的世界：中国版》的上海网之易璀璨网络科技有限公司
+
+NOT AN OFFICIAL MINECRAFT PRODUCT.
+
+NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
+
+NOT APPROVED BY OR ASSOCIATED WITH NETEASE.

README_EN.md

@@ -0,0 +1,138 @@
+[Bilibili: Eilles]: https://img.shields.io/badge/Bilibili-%E9%87%91%E7%BE%BFEilles-00A1E7?style=for-the-badge
+[Bilibili: Alioth]: https://img.shields.io/badge/Bilibili-%E7%8E%89%E8%A1%A1Alioth-00A1E7?style=for-the-badge
+[CodeStyle: black]: https://img.shields.io/badge/code%20style-black-121110.svg?style=for-the-badge
+[python]: https://img.shields.io/badge/python-3.8-AB70FF?style=for-the-badge
+[release]: https://img.shields.io/github/v/release/EillesWan/Musicreater?style=for-the-badge
+[license]: https://img.shields.io/badge/Licence-%E6%B1%89%E9%92%B0%E5%BE%8B%E8%AE%B8%E5%8F%AF%E5%8D%8F%E8%AE%AE-228B22?style=for-the-badge
+
+<h1 align="center">
+    音·创 Musicreater
+</h1>
+
+<p align="center">
+    <img width="128" height="128" src="https://s1.ax1x.com/2022/05/06/Ouhghj.md.png" >
+    </img>
+</p>
+
+<h3 align="center">A free and open-source library for handling with <i>Minecraft</i> digital music.</h3>
+
+<p align="center">
+    <img src="https://img.shields.io/badge/BUILD%20WITH%20LOVE-FF3432?style=for-the-badge">
+    </img>
+<p>
+
+[![][Bilibili: Eilles]](https://space.bilibili.com/397369002/)
+[![][Bilibili: Alioth]](https://space.bilibili.com/604072474)
+[![CodeStyle: black]](https://github.com/psf/black)
+[![][python]](https://www.python.org/)
+[![][license]](LICENSE)
+[![][release]](../../releases)
+
+[![GiteeStar](https://gitee.com/TriM-Organization/Musicreater/badge/star.svg?theme=gray)](https://gitee.com/TriM-Organization/Musicreater/stargazers)
+[![GiteeFork](https://gitee.com/TriM-Organization/Musicreater/badge/fork.svg?theme=gray)](https://gitee.com/TriM-Organization/Musicreater/members)
+[![GitHub Repo stars](https://img.shields.io/github/stars/TriM-Organization/Musicreater?color=white&logo=GitHub&style=plastic)](https://github.com/TriM-Organization/Musicreater/stargazers)
+[![GitHub Repo Forks](https://img.shields.io/github/forks/TriM-Organization/Musicreater?color=white&logo=GitHub&style=plastic)](https://github.com/TriM-Organization/Musicreater/forks)
+
+[简体中文 🇨🇳](README.md) | English🇬🇧
+
+**Notice that the localizations of documents may probably NOT be up-to-date. The original document is in Chinese.**
+
+## Introduction🚀
+
+Musicreater is a free open-source library used for handling with digital musics that being able to be played in _Minecraft_.
+
+Welcome to join our QQ group: [861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)
+
+> **NOTICE** The project inside this repository is only the support library, which is mainly for the developers of music related software for _Minecraft: Bedrock Edition_.
+>
+> The _Bedrock Edition music convertor_ which is for common users is in [Linglun Converter](../../../Linglun-Converter).
+> 
+> We are also developing a _BE music editor_ (digital audio workstation): [Linglun](../../../LinglunStudio)
+
+
+## Installation 🔳
+
+-   Via pypi
+
+    ```bash
+    pip install Musicreater --upgrade
+    ```
+
+-   If above command cannot fetch latest version, try:
+
+    ```bash
+    pip install -i https://pypi.python.org/simple Musicreater --upgrade
+    ```
+
+-   Clone repo and Install (Latest but **NOT RECOMMANDED**):
+    ```bash
+    git clone https://github.com/TriM-Organization/Musicreater.git
+    cd Musicreater
+    python setup.py install
+    ```
+
+Commands such as `python`、`pip` could be changed to some like `python3` or `pip3` according to the difference of platforms.
+
+## Documentation 📄
+
+(Not in English yet)
+
+[生成文件的使用](./docs/%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)
+
+[仓库 API 文档](./docs/%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md)
+
+### Authors ✒
+
+**Eilles (金羿)**：A student, individual developer, unfamous Bilibili UPer, which knows a little about commands in _Minecraft: Bedrock Edition_
+
+**Alioth (玉衡Alioth)**: A student, player of _Minecraft: Bedrock Edition_, which is a fan of music and programming.
+
+**Touch (偷吃不是 Touch)**: A man who is good at using command(s) in _Minecraft: Bedrock Edition_, who supported us of debugging and testing program and algorithm
+
+## Acknowledgements 🙏
+
+This list is not in any order.
+
+-   Thank _昀梦_\<QQ1515399885\> for finding and correcting the bugs in the commands that _Musicreater_ generated.
+-   Thank _Charlie_Ping “查理平”_ for the bdx convert function for reference, and the reference chart that's used to convert the mid's instruments into Minecraft's instruments.
+-   Thank _[CMA_2401PT](https://github.com/CMA2401PT)_ for BDXWorkShop for reference of the .bdx structure's operation, and his guidance in some aspects of our development.
+-   Thank _[Dislink Sforza](https://github.com/Dislink) “断联·斯福尔扎”_ \<QQ1600515314\> for his midi analysis algorithm brought to us, we had adapted it and made it applied in one of our working method; Also, thank him for the [WebConvertor](https://dislink.github.io/midi2bdx/) which brought us so much pressure and power to develop as well as update our projects better, instead of loaf on our project.
+-   Thank _Mono_\<QQ738893087\> for reporting problems while installing
+-   Thank _Ammelia “艾米利亚”_\<QQ2838334637\> for urging us to develop new functions, and put forward a lot of excellent suggestions for new functions, as well as the BDX file's importing test support provided, which has given a lot of practical theoretical support for our new Structure Generating Algorithm
+-   Thank _[神羽](https://gitee.com/snowykami) “[SnowyKami](https://github.com/snowyfirefly)”_ for supporting and promoting our project, and also thanks him for his server which given us to use for free.
+-   Thank _指令师\_苦力怕 “playjuice123”_\<QQ240667197\> for finding bugs within our code, and noticed us to repair a big problem.
+-   Thank _雷霆_\<QQ3555268519\> for his annoying and provoking operations which may awake some problems within the program by chance and reminding us to repair.
+-   Thank _小埋_\<QQ2039310975\> for reporting the empty add-on packs title and description problem.
+-   <table><tr><td>Thank <i>油炸</i> &lt;QQ2836146704&gt; for inspiring us to constantly develop something new.</td><td><img width="260" src="https://foruda.gitee.com/images/1695478907647543027/08ea9909_9911226.jpeg" alt="The groupmate on the picture was saying that our convert-QQ-bot had once brought him great convinience but now it closed down by some reason so he was feeling regretful." title="&quot;It was once, a convert-QQ-bot is just in front my eyes&quot;&#10;&quot;Until lose, I finally know cannot chase back what I needs&quot;"></td><td><small>&quot;It was once, a convert-QQ-bot is just in front my eyes&quot;<br>&quot;Until lose, I finally know cannot chase back what I needs&quot;</small></td></tr></table>
+-   Thank _雨_\<QQ237667809\> for give us report that under the new `execute` command format that the scoreboard player's add-on packs cannot play correctly.
+-   Thank _梦幻duang_\<QQ13753593\> for providing us with his knowlodeg of the command format in Minecraft: Java Edition Version 1.12.2.
+-   Thank [_Open Note Block Studio_](https://github.com/OpenNBS/NoteBlockStudio)'s Project for giving us the power and energy of continual developing.
+
+> Thanks for the support and help of a lot of groupmates  
+> If you have given contributions but have not been in the list, please contact us!
+
+## Contact Us 📞
+
+Meet problems? Welcome to give out your issue [here](../../issues/new)!
+
+Want to get in contact of developers? Welcome to join our [Chat QQ group](https://jq.qq.com/?_wv=1027&k=hpeRxrYr).
+
+Or contact us via [TriM-Org Official Email](mailto:TriM-Organization@hotmail.com)!
+
+---
+
+NOT AN OFFICIAL MINECRAFT PRODUCT.
+
+NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
+
+NOT APPROVED BY OR ASSOCIATED WITH NETEASE.
+
+此项目并非一个官方 《我的世界》（_Minecraft_）项目
+
+此项目不隶属或关联于 Mojang Studios 或 微软
+
+此项目亦不隶属或关联于 网易 相关
+
+“Minecraft”是 Mojang Synergies AB 的商标，此项目中所有对于“我的世界”、“Minecraft”等相关称呼均为必要的介绍性使用
+
+-   上文提及的 网易 公司，指代的是在中国大陆运营《我的世界：中国版》的上海网之易璀璨网络科技有限公司

README_en.md

@@ -1,104 +0,0 @@
-# Musicreater
-
-### Introduction
-Musicreater(音·创) is an Eilles(*W-YI*)'s app that is used for creating musics in **Minecraft: Bedrock Edition**.
-
-Welcome to join our QQ group: 861684859
-
-###Author
-
-Eilles (金羿)：The main author, who developed the most and especially the principal parts of Musicreater, and its predecessors, which has been called as "*Minecraft Function Music Maker*", "*Note Fun Creater*", "*Note World Creater*"(now ,they are united as ***Musicreater***!)
-
-bgArray "诸葛亮与八卦阵": Fix bugs, improve code aesthetics, add new functions, change data format, etc.
-
-### Framework
-
-Using *Python* to develop, using Tkinter as a graphics library.
-
-Support Windows7+ && Linux (that supports Python3.8)
-
-***ATTENTION TO DEVELOPERS!!! TO SUPPORT DIFFERENT LANGUAGES, PLEASE USE CONSTANT `READABLETEXT` TO OUTPUT!!! IF YOU NEED TO SUPPLEMENT, PLEASE ADD THEM IN SIMPLEFIED CHINESE\'S LANGUAGE FILE(zhCN.py), WHEATHER WHAT LANGUAGE YOU USE!!!***
-
-
-### Installation
-
-Comming soon...
-
-### Run with Source Code
-
-#### Windows
-
-0.  First, download the source code pack of Musicreater.
-    [Download from Gitee (Need to Login)](https://gitee.com/EillesWan/Musicreater/repository/archive/master.zip)
-    [Download from Github](https://github.com/EillesWan/Musicreater/archive/refs/heads/master.zip)
-1.  Install Python 3.8.10 
-    [Download the 64-bit Python Installer](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe)
-    [Download the 32-bit Python Installer](https://www.python.org/ftp/python/3.8.10/python-3.8.10.exe)
-2.  After completing installation, we need to install the libraries :
-    -   Open "Start Menu" and find `cmd`
-    -   Run `cmd` as Administrator
-    -   Drag "补全库.py" into the opened window and press Enter
-3.  After completing installation，double click Musicreater.py to run
-
-#### Linux
-
-0.  If you 're not sure whether your environment is good enough, please run these commands on Terminal
-```bash
-sudo apt-get update
-sudo apt-get upgrade
-sudo apt-get install python3
-sudo apt-get install python3-pip
-sudo apt-get install git
-```
-1.  Now if you are confident enough about your runtime environment, open Terminal on the place which you want to download Musicreater, and run these
-```bash
-sudo git clone https://gitee.com/EillesWan/Musicreater.git
-cd Musicreater
-python3 补全库.py
-python3 Musicreater.py
-```
-
-
-### Instructions
-
-1.  Just make u understand the Chinese
-2.  If u dont understand, u can come to the QQ group or email me to ask questions
-3.  The English Edition is comming soon.
-
-
-### Explanation of bgArray 诸葛亮与八卦阵 (unnecessary)
-
-1. First! The tips here are for those who want to use the multi tone resource package, [Shenyu resource package (Shenyu's own link)](https://pan.baidu.com/s/11uoq5zwN7c3rX-98DqVpJg) \(Extraction code: `ek3t`\)
-2. Download it to any location on your PC. Note that it does ***not*** need to be placed in the directory where *Musicreater* are. The audio resource package is large, so you can choose to download only:`神羽资源包_乐器、音源的资源包\羽音缭绕-midiout_25.0`.
-    Also, you can download only `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\mcpack(国际版推荐)格式_25.0` or 
-    `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\zip格式_25.0`.
-4. The next step is the most IMPORTANT: to bind the resource package to *Musicreater*
-    First, open *Musicreater*->Q&A->Select \[MiraclePlumeResourcePack\]... .At this time, in the selection box,
-    the IMPORTANT step comes, select: ***The directory you downloaded: `羽音缭绕-midiout_25.0`, or also the parent directory `mcpack(国际版推荐)格式_25.0`or`zip格式_25.0`***
-    For example, my file path is as follows:
-    `L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0` and in the directory, there are two folders and one .xls file:
-    `神羽资源包_25.0_使用方法.xls`, `mcpack(国际版推荐)格式_25.0` and `zip格式_25.0`, so in *Musicreater* you should also select this folder: **L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0**
-6. If you want to use the Miracle Plume Bedrock Edition Audio Resource Pack to make .mcfunction s, you should use Musicreater -> Edit - > Import audio tracks from MIDI and parse them with a new method, and then use it
-Musicreater - > function (package) - > the following four new functions
-
-### Thanks
-
-1.  Thank [Fuckcraft](https://github.com/fuckcraft) (“鸣凤鸽子” ,etc) for the function of Creating the Websocket Server for Minecraft: Bedrock Edition.
-    -   *!! They have given me the rights to directly copy the lib into Musicreater*
-2.  Thank 昀梦\<QQ1515399885\> for finding and correcting the bugs in the commands that *Musicreater* Created.
-3.  Thank Charlie_Ping “查理平” for bdx convert funtion.
-4.  Thank CMA_2401PT for BDXWorkShop as the .bdx structure's operation guide.
-5.  Thank Miracle Plume “神羽” \<QQshenyu40403\> for the Miracle Plume Bedrock Edition Audio Resource Pack
-6.  Thanks for a lot of groupmates who support me and help me to test the program.
-7.  If you have give me some help but u haven't been in the list, please contact me.
-
-
-### Contact *Eilles(W-YI)*(金羿)
-
-1.  QQ       2647547478
-2.  E-mail   EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
-3.  WeChat   WYI_DoctorYI
-
-### Contact *bgArray*(诸葛亮与八卦阵)
-
-1.  QQ       4740437765

TO-DO.md

@@ -0,0 +1,48 @@
+# 任务清单
+
+## 待办事项
+-	乐曲文件格式设计
+	目前想到的是：
+	1.	使用 `.MCT` 作为项目文件的后缀，然后考虑一下格式是否和之前的 MusicSequence 兼容，如果兼容的话可以照旧用 `.MSQ`，如不的话，可以试试想一个新的后缀名作为数据文件后缀
+	2.	要求数据文件支持完全流式读入
+
+-	音轨静音处理
+	当前没有处理
+
+-	优化音轨的存储方式
+	当前是用列表，且每一次变动元素都要重新排序，这样消耗太大了，需要优化，改用最小堆形式（heapq）
+
+-	移植 v2 功能到内置插件
+	目前 v2 的功能有很多，都要移植到 v3。
+	1.	导入 Midi 文件到全曲
+	2.	导入 Midi 文件到指定轨道
+	3.	导出到延迟播放器的结构文件（MCSTRUCTURE、BDX）
+	4.	导出到延迟播放器的附加包
+	5.	导出到积分板播放器的以上两种形式
+	6.	导出到中继器播放器的以上两种形式
+	7.	在 WebSocket 播放器中播放
+	8.	导出到支持神羽资源包的以上 7 种形式
+	9.	对于 Midi 歌词的实验性功能
+	10.	对于 Java 版本适配的实验性功能
+	11.	对于听感优化的实验性功能（插值、偏移）
+
+-	测试参数曲线的功能
+
+-	支持导出音符盒构成的音乐
+
+-	支持导出成 schematic 结构
+
+## 讨论
+
+1.	[x]	是否应该在插件注册表 PluginRegistry 中采用 `Dict[插件名, 插件对象]` 的形式存储插件？
+	当前不采用这种方式是认为可以兼容一些极端场景下用户将一堆同名插件放在一起的情况。但是就算是插件放在一起，我们也可以有选择地读入注册表，比如依照版本号只读取最高版本的插件，并不需要全部存储在插件注册表中。所以其实用字典来存储是有利的？吗？
+	
+	**当前已解决**
+
+	引入了插件惟一识别码之后当然是采用 `Dict[插件唯一识别码, 插件对象]` 来存储插件了~之前插件名称的内容是我想得太浅了，我写完所有代码之后才想到插件名称是中文还带空格的任意字符串……
+
+2.	服务插件到底该怎么写？总不能留着一个 PluginType.SERVICE 的插件一直空在那里吧……
+
+3.	插件依赖性的优化。目前没有处理各个插件依赖关系的问题，如果插件之间彼此依赖要怎么做？
+	我的想法是，这个依赖的处理由调用端来完成。比如我们的 伶伦工作站 是以 音·创 为核心的一个可视化数字音频工作站。
+	那么应该由伶伦来处理依赖关系并加载之。

bgArrayLib/namesConstant.py

@@ -1,92 +0,0 @@
-zip_name = {-1: '-1.Acoustic_Kit_打击乐.zip', 0: '0.Acoustic_Grand_Piano_大钢琴.zip', 1: '1.Bright_Acoustic_Piano_亮音大钢琴.zip',
-            10: '10.Music_Box_八音盒.zip', 100: '100.FX_brightness_合成特效-亮音.zip', 101: '101.FX_goblins_合成特效-小妖.zip',
-            102: '102.FX_echoes_合成特效-回声.zip', 103: '103.FX_sci-fi_合成特效-科幻.zip', 104: '104.Sitar_锡塔尔.zip',
-            105: '105.Banjo_班卓.zip', 106: '106.Shamisen_三味线.zip', 107: '107.Koto_筝.zip', 108: '108.Kalimba_卡林巴.zip',
-            109: '109.Bagpipe_风笛.zip', 11: '11.Vibraphone_电颤琴.zip', 110: '110.Fiddle_古提琴.zip', 111: '111.Shanai_唢呐.zip',
-            112: '112.Tinkle_Bell_铃铛.zip', 113: '113.Agogo_拉丁打铃.zip', 114: '114.Steel_Drums_钢鼓.zip',
-            115: '115.Woodblock_木块.zip', 116: '116.Taiko_Drum_太鼓.zip', 117: '117.Melodic_Tom_嗵鼓.zip',
-            118: '118.Synth_Drum_合成鼓.zip', 119: '119.Reverse_Cymbal_镲波形反转.zip', 12: '12.Marimba_马林巴.zip',
-            13: '13.Xylophone_木琴.zip', 14: '14.Tubular_Bells_管钟.zip', 15: '15.Dulcimer_扬琴.zip',
-            16: '16.Drawbar_Organ_击杆风琴.zip', 17: '17.Percussive_Organ_打击型风琴.zip', 18: '18.Rock_Organ_摇滚风琴.zip',
-            19: '19.Church_Organ_管风琴.zip', 2: '2.Electric_Grand_Piano_电子大钢琴.zip', 20: '20.Reed_Organ_簧风琴.zip',
-            21: '21.Accordion_手风琴.zip', 22: '22.Harmonica_口琴.zip', 23: '23.Tango_Accordian_探戈手风琴.zip',
-            24: '24.Acoustic_Guitar_(nylon)_尼龙弦吉他.zip', 25: '25.Acoustic_Guitar(steel)_钢弦吉他.zip',
-            26: '26.Electric_Guitar_(jazz)_爵士乐电吉他.zip', 27: '27.Electric_Guitar_(clean)_清音电吉他.zip',
-            28: '28.Electric_Guitar_(muted)_弱音电吉他.zip', 29: '29.Overdriven_Guitar_驱动音效吉他.zip',
-            3: '3.Honky-Tonk_Piano_酒吧钢琴.zip', 30: '30.Distortion_Guitar_失真音效吉他.zip', 31: '31.Guitar_Harmonics_吉他泛音.zip',
-            32: '32.Acoustic_Bass_原声贝司.zip', 33: '33.Electric_Bass(finger)_指拨电贝司.zip',
-            34: '34.Electric_Bass(pick)_拨片拨电贝司.zip', 35: '35.Fretless_Bass_无品贝司.zip', 36: '36.Slap_Bass_A_击弦贝司A.zip',
-            37: '37.Slap_Bass_B_击弦贝司B.zip', 38: '38.Synth_Bass_A_合成贝司A.zip', 39: '39.Synth_Bass_B_合成贝司B.zip',
-            4: '4.Electric_Piano_1_电钢琴A.zip', 40: '40.Violin_小提琴.zip', 41: '41.Viola_中提琴.zip', 42: '42.Cello_大提琴.zip',
-            43: '43.Contrabass_低音提琴.zip', 44: '44.Tremolo_Strings_弦乐震音.zip', 45: '45.Pizzicato_Strings_弦乐拨奏.zip',
-            46: '46.Orchestral_Harp_竖琴.zip', 47: '47.Timpani_定音鼓.zip', 48: '48.String_Ensemble_A_弦乐合奏A.zip',
-            49: '49.String_Ensemble_B_弦乐合奏B.zip', 5: '5.Electric_Piano_2_电钢琴B.zip', 50: '50.SynthStrings_A_合成弦乐A.zip',
-            51: '51.SynthStrings_B_合成弦乐B.zip', 52: '52.Choir_Aahs_合唱“啊”音.zip', 53: '53.Voice_Oohs_人声“哦”音.zip',
-            54: '54.Synth_Voice_合成人声.zip', 55: '55.Orchestra_Hit_乐队打击乐.zip', 56: '56.Trumpet_小号.zip',
-            57: '57.Trombone_长号.zip', 58: '58.Tuba_大号.zip', 59: '59.Muted_Trumpet_弱音小号.zip',
-            6: '6.Harpsichord_拨弦古钢琴.zip', 60: '60.French_Horn_圆号.zip', 61: '61.Brass_Section_铜管组.zip',
-            62: '62.Synth_Brass_A_合成铜管A.zip', 63: '63.Synth_Brass_A_合成铜管B.zip', 64: '64.Soprano_Sax_高音萨克斯.zip',
-            65: '65.Alto_Sax_中音萨克斯.zip', 66: '66.Tenor_Sax_次中音萨克斯.zip', 67: '67.Baritone_Sax_上低音萨克斯.zip',
-            68: '68.Oboe_双簧管.zip', 69: '69.English_Horn_英国管.zip', 7: '7.Clavinet_击弦古钢琴.zip', 70: '70.Bassoon_大管.zip',
-            71: '71.Clarinet_单簧管.zip', 72: '72.Piccolo_短笛.zip', 73: '73.Flute_长笛.zip', 74: '74.Recorder_竖笛.zip',
-            75: '75.Pan_Flute_排笛.zip', 76: '76.Bottle_Blow_吹瓶口.zip', 77: '77.Skakuhachi_尺八.zip', 78: '78.Whistle_哨.zip',
-            79: '79.Ocarina_洋埙.zip', 8: '8.Celesta_钢片琴.zip', 80: '80.Lead_square_合成主音-方波.zip',
-            81: '81.Lead_sawtooth_合成主音-锯齿波.zip', 82: '82.Lead_calliope_lead_合成主音-汽笛风琴.zip',
-            83: '83.Lead_chiff_lead_合成主音-吹管.zip', 84: '84.Lead_charang_合成主音5-吉他.zip', 85: '85.Lead_voice_合成主音-人声.zip',
-            86: '86.Lead_fifths_合成主音-五度.zip', 87: '87.Lead_bass+lead_合成主音-低音加主音.zip', 88: '88.Pad_new_age_合成柔音-新时代.zip',
-            89: '89.Pad_warm_合成柔音-暖音.zip', 9: '9.Glockenspiel_钟琴.zip', 90: '90.Pad_polysynth_合成柔音-复合成.zip',
-            91: '91.Pad_choir_合成柔音-合唱.zip', 92: '92.Pad_bowed_合成柔音-弓弦.zip', 93: '93.Pad_metallic_合成柔音-金属.zip',
-            94: '94.Pad_halo_合成柔音-光环.zip', 95: '95.Pad_sweep_合成柔音-扫弦.zip', 96: '96.FX_rain_合成特效-雨.zip',
-            97: '97.FX_soundtrack_合成特效-音轨.zip', 98: '98.FX_crystal_合成特效-水晶.zip', 99: '99.FX_atmosphere_合成特效-大气.zip'}
-
-mcpack_name = {-1: '-1.Acoustic_Kit_打击乐.mcpack', 0: '0.Acoustic_Grand_Piano_大钢琴.mcpack',
-               1: '1.Bright_Acoustic_Piano_亮音大钢琴.mcpack', 10: '10.Music_Box_八音盒.mcpack',
-               100: '100.FX_brightness_合成特效-亮音.mcpack', 101: '101.FX_goblins_合成特效-小妖.mcpack',
-               102: '102.FX_echoes_合成特效-回声.mcpack', 103: '103.FX_sci-fi_合成特效-科幻.mcpack', 104: '104.Sitar_锡塔尔.mcpack',
-               105: '105.Banjo_班卓.mcpack', 106: '106.Shamisen_三味线.mcpack', 107: '107.Koto_筝.mcpack',
-               108: '108.Kalimba_卡林巴.mcpack', 109: '109.Bagpipe_风笛.mcpack', 11: '11.Vibraphone_电颤琴.mcpack',
-               110: '110.Fiddle_古提琴.mcpack', 111: '111.Shanai_唢呐.mcpack', 112: '112.Tinkle_Bell_铃铛.mcpack',
-               113: '113.Agogo_拉丁打铃.mcpack', 114: '114.Steel_Drums_钢鼓.mcpack', 115: '115.Woodblock_木块.mcpack',
-               116: '116.Taiko_Drum_太鼓.mcpack', 117: '117.Melodic_Tom_嗵鼓.mcpack', 118: '118.Synth_Drum_合成鼓.mcpack',
-               119: '119.Reverse_Cymbal_镲波形反转.mcpack', 12: '12.Marimba_马林巴.mcpack', 13: '13.Xylophone_木琴.mcpack',
-               14: '14.Tubular_Bells_管钟.mcpack', 15: '15.Dulcimer_扬琴.mcpack', 16: '16.Drawbar_Organ_击杆风琴.mcpack',
-               17: '17.Percussive_Organ_打击型风琴.mcpack', 18: '18.Rock_Organ_摇滚风琴.mcpack',
-               19: '19.Church_Organ_管风琴.mcpack', 2: '2.Electric_Grand_Piano_电子大钢琴.mcpack',
-               20: '20.Reed_Organ_簧风琴.mcpack', 21: '21.Accordion_手风琴.mcpack', 22: '22.Harmonica_口琴.mcpack',
-               23: '23.Tango_Accordian_探戈手风琴.mcpack', 24: '24.Acoustic_Guitar_(nylon)_尼龙弦吉他.mcpack',
-               25: '25.Acoustic_Guitar(steel)_钢弦吉他.mcpack', 26: '26.Electric_Guitar_(jazz)_爵士乐电吉他.mcpack',
-               27: '27.Electric_Guitar_(clean)_清音电吉他.mcpack', 28: '28.Electric_Guitar_(muted)_弱音电吉他.mcpack',
-               29: '29.Overdriven_Guitar_驱动音效吉他.mcpack', 3: '3.Honky-Tonk_Piano_酒吧钢琴.mcpack',
-               30: '30.Distortion_Guitar_失真音效吉他.mcpack', 31: '31.Guitar_Harmonics_吉他泛音.mcpack',
-               32: '32.Acoustic_Bass_原声贝司.mcpack', 33: '33.Electric_Bass(finger)_指拨电贝司.mcpack',
-               34: '34.Electric_Bass(pick)_拨片拨电贝司.mcpack', 35: '35.Fretless_Bass_无品贝司.mcpack',
-               36: '36.Slap_Bass_A_击弦贝司A.mcpack', 37: '37.Slap_Bass_B_击弦贝司B.mcpack', 38: '38.Synth_Bass_A_合成贝司A.mcpack',
-               39: '39.Synth_Bass_B_合成贝司B.mcpack', 4: '4.Electric_Piano_1_电钢琴A.mcpack', 40: '40.Violin_小提琴.mcpack',
-               41: '41.Viola_中提琴.mcpack', 42: '42.Cello_大提琴.mcpack', 43: '43.Contrabass_低音提琴.mcpack',
-               44: '44.Tremolo_Strings_弦乐震音.mcpack', 45: '45.Pizzicato_Strings_弦乐拨奏.mcpack',
-               46: '46.Orchestral_Harp_竖琴.mcpack', 47: '47.Timpani_定音鼓.mcpack', 48: '48.String_Ensemble_A_弦乐合奏A.mcpack',
-               49: '49.String_Ensemble_B_弦乐合奏B.mcpack', 5: '5.Electric_Piano_2_电钢琴B.mcpack',
-               50: '50.SynthStrings_A_合成弦乐A.mcpack', 51: '51.SynthStrings_B_合成弦乐B.mcpack',
-               52: '52.Choir_Aahs_合唱“啊”音.mcpack', 53: '53.Voice_Oohs_人声“哦”音.mcpack', 54: '54.Synth_Voice_合成人声.mcpack',
-               55: '55.Orchestra_Hit_乐队打击乐.mcpack', 56: '56.Trumpet_小号.mcpack', 57: '57.Trombone_长号.mcpack',
-               58: '58.Tuba_大号.mcpack', 59: '59.Muted_Trumpet_弱音小号.mcpack', 6: '6.Harpsichord_拨弦古钢琴.mcpack',
-               60: '60.French_Horn_圆号.mcpack', 61: '61.Brass_Section_铜管组.mcpack', 62: '62.Synth_Brass_A_合成铜管A.mcpack',
-               63: '63.Synth_Brass_A_合成铜管B.mcpack', 64: '64.Soprano_Sax_高音萨克斯.mcpack', 65: '65.Alto_Sax_中音萨克斯.mcpack',
-               66: '66.Tenor_Sax_次中音萨克斯.mcpack', 67: '67.Baritone_Sax_上低音萨克斯.mcpack', 68: '68.Oboe_双簧管.mcpack',
-               69: '69.English_Horn_英国管.mcpack', 7: '7.Clavinet_击弦古钢琴.mcpack', 70: '70.Bassoon_大管.mcpack',
-               71: '71.Clarinet_单簧管.mcpack', 72: '72.Piccolo_短笛.mcpack', 73: '73.Flute_长笛.mcpack',
-               74: '74.Recorder_竖笛.mcpack', 75: '75.Pan_Flute_排笛.mcpack', 76: '76.Bottle_Blow_吹瓶口.mcpack',
-               77: '77.Skakuhachi_尺八.mcpack', 78: '78.Whistle_哨.mcpack', 79: '79.Ocarina_洋埙.mcpack',
-               8: '8.Celesta_钢片琴.mcpack', 80: '80.Lead_square_合成主音-方波.mcpack', 81: '81.Lead_sawtooth_合成主音-锯齿波.mcpack',
-               82: '82.Lead_calliope_lead_合成主音-汽笛风琴.mcpack', 83: '83.Lead_chiff_lead_合成主音-吹管.mcpack',
-               84: '84.Lead_charang_合成主音5-吉他.mcpack', 85: '85.Lead_voice_合成主音-人声.mcpack',
-               86: '86.Lead_fifths_合成主音-五度.mcpack', 87: '87.Lead_bass+lead_合成主音-低音加主音.mcpack',
-               88: '88.Pad_new_age_合成柔音-新时代.mcpack', 89: '89.Pad_warm_合成柔音-暖音.mcpack', 9: '9.Glockenspiel_钟琴.mcpack',
-               90: '90.Pad_polysynth_合成柔音-复合成.mcpack', 91: '91.Pad_choir_合成柔音-合唱.mcpack',
-               92: '92.Pad_bowed_合成柔音-弓弦.mcpack', 93: '93.Pad_metallic_合成柔音-金属.mcpack',
-               94: '94.Pad_halo_合成柔音-光环.mcpack', 95: '95.Pad_sweep_合成柔音-扫弦.mcpack', 96: '96.FX_rain_合成特效-雨.mcpack',
-               97: '97.FX_soundtrack_合成特效-音轨.mcpack', 98: '98.FX_crystal_合成特效-水晶.mcpack',
-               99: '99.FX_atmosphere_合成特效-大气.mcpack'}
-
-if __name__ == '__main__':
-    print(zip_name[0])

bgArrayLib/pitchStrConstant.py

@@ -1,133 +0,0 @@
-pitch = {
-            '0': '0.0220970869120796',
-            '1': '0.0234110480761981',
-            '2': '0.0248031414370031',
-            '3': '0.0262780129766786',
-            '4': '0.0278405849418856',
-            '5': '0.0294960722713029',
-            '6': '0.03125',
-            '7': '0.033108221698728',
-            '8': '0.0350769390096679',
-            '9': '0.037162722343835',
-            '10': '0.0393725328092148',
-            '11': '0.0417137454428136',
-            '12': '0.0441941738241592',
-            '13': '0.0468220961523963',
-            '14': '0.0496062828740062',
-            '15': '0.0525560259533572',
-            '16': '0.0556811698837712',
-            '17': '0.0589921445426059',
-            '18': '0.0625',
-            '19': '0.066216443397456',
-            '20': '0.0701538780193358',
-            '21': '0.0743254446876701',
-            '22': '0.0787450656184296',
-            '23': '0.0834274908856271',
-            '24': '0.0883883476483184',
-            '25': '0.0936441923047926',
-            '26': '0.0992125657480125',
-            '27': '0.105112051906714',
-            '28': '0.111362339767542',
-            '29': '0.117984289085212',
-            '30': '0.125',
-            '31': '0.132432886794912',
-            '32': '0.140307756038672',
-            '33': '0.14865088937534',
-            '34': '0.157490131236859',
-            '35': '0.166854981771254',
-            '36': '0.176776695296637',
-            '37': '0.187288384609585',
-            '38': '0.198425131496025',
-            '39': '0.210224103813429',
-            '40': '0.222724679535085',
-            '41': '0.235968578170423',
-            '42': '0.25',
-            '43': '0.264865773589824',
-            '44': '0.280615512077343',
-            '45': '0.29730177875068',
-            '46': '0.314980262473718',
-            '47': '0.333709963542509',
-            '48': '0.353553390593274',
-            '49': '0.37457676921917',
-            '50': '0.39685026299205',
-            '51': '0.420448207626857',
-            '52': '0.44544935907017',
-            '53': '0.471937156340847',
-            '54': '0.5',
-            '55': '0.529731547179648',
-            '56': '0.561231024154687',
-            '57': '0.594603557501361',
-            '58': '0.629960524947437',
-            '59': '0.667419927085017',
-            '60': '0.707106781186548',
-            '61': '0.749153538438341',
-            '62': '0.7937005259841',
-            '63': '0.840896415253715',
-            '64': '0.890898718140339',
-            '65': '0.943874312681694',
-            '66': '1',
-            '67': '1.0594630943593',
-            '68': '1.12246204830937',
-            '69': '1.18920711500272',
-            '70': '1.25992104989487',
-            '71': '1.33483985417003',
-            '72': '1.4142135623731',
-            '73': '1.49830707687668',
-            '74': '1.5874010519682',
-            '75': '1.68179283050743',
-            '76': '1.78179743628068',
-            '77': '1.88774862536339',
-            '78': '2',
-            '79': '2.11892618871859',
-            '80': '2.24492409661875',
-            '81': '2.37841423000544',
-            '82': '2.51984209978975',
-            '83': '2.66967970834007',
-            '84': '2.82842712474619',
-            '85': '2.99661415375336',
-            '86': '3.1748021039364',
-            '87': '3.36358566101486',
-            '88': '3.56359487256136',
-            '89': '3.77549725072677',
-            '90': '4',
-            '91': '4.23785237743718',
-            '92': '4.48984819323749',
-            '93': '4.75682846001088',
-            '94': '5.03968419957949',
-            '95': '5.33935941668014',
-            '96': '5.65685424949238',
-            '97': '5.99322830750673',
-            '98': '6.3496042078728',
-            '99': '6.72717132202972',
-            '100': '7.12718974512272',
-            '101': '7.55099450145355',
-            '102': '8',
-            '103': '8.47570475487436',
-            '104': '8.97969638647498',
-            '105': '9.51365692002177',
-            '106': '10.079368399159',
-            '107': '10.6787188333603',
-            '108': '11.3137084989848',
-            '109': '11.9864566150135',
-            '110': '12.6992084157456',
-            '111': '13.4543426440594',
-            '112': '14.2543794902454',
-            '113': '15.1019890029071',
-            '114': '16',
-            '115': '16.9514095097487',
-            '116': '17.95939277295',
-            '117': '19.0273138400435',
-            '118': '20.158736798318',
-            '119': '21.3574376667206',
-            '120': '22.6274169979695',
-            '121': '23.9729132300269',
-            '122': '25.3984168314912',
-            '123': '26.9086852881189',
-            '124': '28.5087589804909',
-            '125': '30.2039780058142',
-            '126': '32',
-            '127': '33.9028190194974',
-            '128': '35.9187855458999',
-            '129': '38.0546276800871',
-            '130': '40.3174735966359',
-            '131': '42.7148753334411'}

clean_update.py

@@ -0,0 +1,22 @@
+import shutil
+import os
+from rich.console import Console
+from rich.progress import track
+
+console = Console()
+
+
+def main():
+    with console.status("寻众迹于 .egg-info 内"):
+        egg_info: list = []
+        for file in os.listdir():
+            if file.endswith(".egg-info"):
+                egg_info.append(file)
+                console.print(file)
+    for file in track(["build", "dist", "logs", *egg_info], description="正删档"):
+        if os.path.isdir(file) and os.access(file, os.W_OK):
+            shutil.rmtree(file)
+
+
+if __name__ == "__main__":
+    main()

docs/API.md

@@ -0,0 +1,13 @@
+<h1 align="center">音·创 Musicreater</h1>
+
+<p align="center">
+<img width="128" height="128" src="https://gitee.com/TriM-Organization/Musicreater/raw/master/resources/msctIcon.png" >
+</p>
+
+**此为开发相关文档，内容包括：库的简单调用、所生成文件结构的详细说明、特殊参数的详细解释**
+
+# [main.py](../Musicreater/main.py)
+
+## [类] MidiConvert
+
+### [类函数] from_midi_file

docs/库的生成与功能文档.md

@@ -0,0 +1,315 @@
+<h1 align="center">音·创 Musicreater</h1>
+
+<p align="center">
+<img width="128" height="128" src="https://gitee.com/TriM-Organization/Musicreater/raw/master/resources/msctIcon.png" >
+</p>
+
+**此为开发相关文档，内容包括：库的简单调用、所生成文件结构的详细说明、特殊参数的详细解释**
+
+# 库的简单调用
+
+参见[example.py的相关部分](../example.py)，使用此库进行MIDI转换非常简单。
+
+-	在导入转换库后，使用 MidiConvert 类建立转换对象（读取Midi文件）
+
+	音·创库支持新旧两种execute语法，需要在对象实例化时指定
+	```python
+	# 导入音·创库
+	import Musicreater
+
+	# 指定是否使用旧的execute指令语法（即1.18及以前的《我的世界：基岩版》语法）
+	old_execute_format = False	
+
+	# 可以通过文件地址自动读取
+	cvt_mid = Musicreater.MidiConvert.from_midi_file(
+		"Midi文件地址", 
+		old_exe_format=old_execute_format
+	)
+
+	# 也可以导入Mido对象
+	cvt_mid = Musicreater.MidiConvert(
+		mido.MidiFile("Midi文件地址"), 
+		"音乐名称", 
+		old_exe_format=old_execute_format
+	)
+	```
+
+-	获取 Midi 音乐经转换后的播放指令
+
+	```python
+	# 通过函数 to_command_list_in_score, to_command_list_in_delay
+	# 分别可以得到
+	# 以计分板作为播放器的指令对象列表、以延迟作为播放器的指令对象列表
+	# 数据不仅存储在对象本身内，也会以返回值的形式返回，详见代码内文档
+	
+	# 使用 to_command_list_in_score 函数进行转换之后，返回值有三个
+	# 值得注意的是第一个返回值返回的是依照midi频道存储的指令对象列表
+	# 也就是列表套列表
+	# 但是，在对象内部所存储的数据却不会如此嵌套
+	command_channel_list, command_count, max_score = cvt_mid.to_command_list_in_score(
+		"计分板名称", 
+		1.0,	# 音量比率
+		1.0,	# 速度倍率
+	)
+
+	# 使用 to_command_list_in_delay 转换后的返回值只有两个
+	# 但是第一个返回值没有列表套列表
+	command_list, max_delay = cvt_mid.to_command_list_in_delay(
+		1.0,	# 音量比率
+		1.0,	# 速度倍率
+		"@a",	# 玩家选择器
+	)
+
+	# 运行之后，指令和总延迟会存储至对象内
+	print(
+		"音乐长度：{}/游戏刻".format(
+			cvt_mid.music_tick_num
+		)
+	)
+	print(
+		"指令如下：\n{}".format(
+			cvt_mid.music_command_list
+		)
+	)
+	```
+
+-	除了获取播放指令外，还可以获取进度条指令
+
+	```python
+	# 通过函数 form_progress_bar 可以获得
+	# 以计分板为载体所生成的进度条的指令对象列表
+	# 数据不仅存储在对象本身内，也会以返回值的形式返回，详见代码内文档
+	
+	# 使用 form_progress_bar 函数进行转换之后，返回值有三个
+	# 值得注意的是第一个返回值返回的是依照midi频道存储的指令对象列表
+	# 也就是列表套列表
+	cvt_mid.form_progress_bar(
+        max_score, 				# 音乐时长游戏刻
+		scoreboard_name, 		# 进度条使用的计分板名称
+		progressbar_style,		# 进度条样式组（详见下方）
+    )
+
+	# 同上面生成播放指令的理，进度条指令也会存储至对象内
+	print(
+		"进度条指令如下：\n{}".format(
+			cvt_mid.progress_bar_command
+		)
+	)
+	```
+
+	在上面的代码中，进度条样式是可以自定义的，详见[下方说明](%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md#进度条自定义)。
+
+- 转换成指令是一个方面，接下来是再转换为可以导入MC的格式。我们提供了 **音·创** 内置的附加组件，可以借助 `MidiConvert` 对象转换为相应格式。
+
+	```python
+	# 导入 Musicreater
+	import Musicreater
+	# 导入附加组件功能
+	import Musicreater.plugin
+
+
+	# 导入相应的文件格式转换功能
+
+	# 转换为函数附加包
+	import Musicreater.plugin.funpack
+	# 转换为 BDX 结构文件
+	import Musicreater.plugin.bdxfile
+	# 转换为 mcstructure 结构文件
+	import Musicreater.plugin.mcstructfile
+	# 转换为结构附加包
+	import Musicreater.plugin.mcstructpack
+	# 直接通过 websocket 功能播放（正在开发）
+	import Musicreater.plugin.websocket
+
+
+	# 定义转换参数
+	cvt_cfg = Musicreater.plugin.ConvertConfig(
+		output_path,
+		volumn,			# 音量大小参数
+		speed,			# 速度倍率
+		progressbar,	# 进度条样式组（详见下方）
+	)
+
+	# 使用附加组件转换，其调用的函数应为：
+	# Musicreater.plugin.输出格式.播放器格式
+	# 值得注意的是，并非所有输出格式都支持所有播放器格式
+	# 调用的时候还请注意甄别
+	# 例如，以下函数是将 MidiConvert 对象 cvt_mid
+	# 以 cvt_cfg 指定的参数
+	# 以延迟播放器转换为 mcstructure 文件
+	Musicreater.plugin.mcstructfile.to_mcstructure_file_in_delay(
+		cvt_mid,
+		cvt_cfg,
+	)
+	```
+
+
+#	生成文件结构
+
+##	名词解释
+
+|名词|解释|备注|
+|--------|-----------|----------|
+|指令区|一个用于放置指令系统的区域，通常是常加载区。|常见于服务器指令系统、好友联机房间中|
+|指令链（链）|与链式指令方块不同，一个指令链通常指代的是一串由某种非链式指令方块作为开头，后面连着一串链式指令方块的结构。|通常的链都应用于需要“单次激活而多指令”的简单功能|
+|起始块|链最初的那个非链式指令方块。|此方块为脉冲方块或重复方块皆可|
+|指令系统（系统）|指令系统通常指的是，由一个或多个指令链以及相关红石机构相互配合、一同组成的，为达到某种特定的功能而构建的整体结构。|通常的系统都应用于需要“综合调配指令”的复杂功能。可由多个实现不同功能的模块构成，不同系统之间可以相互调用各自的模块。|
+|游戏刻（刻）|游戏的一刻是指《我的世界》的游戏进程循环运行一次所占用的时间。（[详见《我的世界》中文维基](https://minecraft.fandom.com/zh/wiki/%E5%88%BB#%E6%B8%B8%E6%88%8F%E5%88%BB)）。指令方块的延迟功能（即指令方块的“延迟刻数”设置项，此项的名称被误译为“已选中项的延迟”）的单位即为`1`游戏刻。|正常情况下，游戏固定以每秒钟 $20$ 刻的速率运行。但是，由于游戏内的绝大多数操作都是基于游戏进程循环而非现实中的时间来计时并进行的，一次游戏循环内也许会发生大量的操作，更多情况下，一秒对应的游戏刻会更少。|
+|红石刻|一个红石刻代表了两个游戏刻。（[详见《我的世界》中文维基](https://minecraft.fandom.com/zh/wiki/%E5%88%BB#%E7%BA%A2%E7%9F%B3%E5%88%BB)）。红石中继器会带来 $1$~$4$ 个红石刻的延迟，其默认的延迟时间为 $1$ 红石刻。|正常情况下，红石信号在一个红石电路中传输回存在 $\frac{1}{10}$ 秒左右的延迟。但是，同理于游戏刻，一秒对应的红石刻是不定的。|
+
+##	播放器
+
+**音·创**生成的文件可以采用多种方式播放，一类播放方式，我们称其为**播放器**，例如**延迟播放器**和**计分板播放器**等等，以后推出的新的播放器，届时也会在此处更新。
+
+为什么要设计这么多播放器？是为了适应不同的播放环境需要。通常情况下，一个音乐中含有多个音符，音符与音符之间存在间隔，这里就产生了不一样的，实现音符间时间间隔的方式。而不同的应用环境下，又会产生不一样的要求。接下来将对不同的播放器进行详细介绍。
+
+### 参数释义
+
+|参数|说明|备注|
+|--------|-----------|----------|
+|`ScBd`|指定的计分板名称||
+|`Tg`|播放对象|选择器或玩家名|
+|`x`|音发出时对应的分数值||
+|`InstID`|声音效果ID|不同的声音ID可以对应不同的乐器，详见转换[乐器对照表](./%E8%BD%AC%E6%8D%A2%E4%B9%90%E5%99%A8%E5%AF%B9%E7%85%A7%E8%A1%A8.md)|
+|`Ht`|播放点对玩家的距离|通过距离来表达声音的响度。以 $S$ 表示此参数`Ht`，以Vol表示音量百分比，则计算公式为： $S = \frac{1}{Vol}-1$ |
+|`Vlct`|原生我的世界中规定的播放力度|这个参数是一个谜一样的存在，似乎它的值毫不重要……因为无论这个值是多少，我们听起来都差不多。当此音符所在MIDI通道为第一通道，则这个值为 $0.7$ 倍MIDI指定力度，其他则为 $0.9$ 倍。|
+|`Ptc`|音符的音高|这是决定音调的参数。以 $P$ 表示此参数， $n$ 表示其在MIDI中的编号， $x$ 表示一定的音调偏移，则计算公式为： $P = 2^\frac{n-60-x}{12}$。之所以存在音调偏移是因为在《我的世界》中，不同的[乐器存在不同的音域](https://zh.minecraft.wiki/wiki/%E9%9F%B3%E7%AC%A6%E7%9B%92#%E4%B9%90%E5%99%A8)，我们通过音调偏移来进行调整。|
+
+### 播放器内容
+
+1.	计分板播放器
+
+	计分板播放器是一种传统的《我的世界》音乐播放方式。通过对于计分板加分来实现播放不同的音符。一个很简单的原理，就是**用不同的计分板分值对应不同的音符**，再通过加分，来达到那个分值，即播放出来。
+
+	在**音·创**中，用来达到这种效果的指令是这样的：
+
+	```mcfunction
+	execute @a[scores={ScBd=x}] ~ ~ ~ playsound InstID @s ^ ^ ^Ht Vlct Ptc
+	```
+
+
+
+	后四个参数决定了这个音的性质，而前两个参数仅仅是为了决定音播放的时间。
+
+2.	延迟播放器
+
+	延迟播放器是通过《我的世界》游戏中，指令方块的设置项“延迟刻数”来达到定位音符的效果。**将所有的音符依照其播放时距离乐曲开始时的时间（毫秒），放在一个序列内，再计算音符两两之间对应的时间差值，转换为《我的世界》内对应的游戏刻数之后填入指令方块的设置中。**
+
+	在**音·创**中，由于此方式播放的音乐不需要用计分板，所以播放指令是这样的：
+
+	```mcfunction
+	execute Tg ~ ~ ~ playsound InstID @s ^ ^ ^Ht Vlct Ptc
+	```
+
+
+	其中后四个参数决定了这个音的性质。
+	
+	由于这样的延迟数据是依赖于指令方块的设置项，所以使用这种播放器所转换出的结果仅可以存储在包含方块NBT信息及方块实体NBT信息的结构文件中，或者直接输出至世界。
+
+3. 中继器播放器
+
+	中继器播放器是一种传统的《我的世界》红石音乐播放方式，利用游戏内“红石组件”之“红石中继器”以达到定位音符之用。**但是，中继器的延迟为1红石刻**
+
+
+##	文件格式
+
+1.	附加包格式（`.mcpack`）
+
+	使用附加包格式导出音乐，若采用计分板 播放器，则音乐会以指令函数文件（`.mcfunction`）存储于附加包内。而若为延迟或中继器播放器，则音乐回以结构文件（`.mcstructure`）存储。在所生成的附加包中，函数文件的存储结构应为：
+
+	- `functions\`
+		- `index.mcfunction`
+		- `stop.mcfunction`
+		- `mscply\`
+			- `progressShow.mcfunction`
+			- `track1.mcfunction`
+			- `track2.mcfunction`
+			- ...
+			- `trackN.mcfunction`
+	- `structures\`
+		- `XXX_main.mcstructure`
+		- `XXX_start.mcstructure`
+		- `XXX_reset.mcstructure`
+		- `XXX_pgb.mcstructure`
+
+	如图，其中，`index.mcfunction`文件、`stop.mcfunction`文件和`mscply`文件夹存在于函数目录的根下；在`mscply`目录中，包含音乐导出的众多音轨播放文件（`trackX.mcfunction`）。同时，若使用计分板播放器生成此包时启用生成进度条，则会包含`progressShow.mcfunction`文件。若选择延迟或中继器播放器，则会生成`structures`目录以及相关`.mcstructure`文件，其中`mian`表示音乐播放用的主要结构；`start`是用于初始化播放的部分，仅包含一个指令方块即起始块；`reset`和`pgb`仅在启用生成进度条时出现，前者用于重置临时计分板，后者用于显示进度条。
+	
+	`index.mcfunction`用于开始播放：
+	
+	1.	若为计分板播放器，则其中包含打开各个音轨对应函数的指令，以及加分指令，这里的加分，是将**播放计分板的值大于等于 $1$ 的所有玩家**的播放计分板分数增加 $1$。同时，若生成此包时选择了自动重置计分板的选项，则会包含一条重置计分板的指令。
+	
+	2.	若为延迟或中继器播放器，则其中的指令仅包含用以正确加载结构的`structure`指令。
+
+	`stop.mcfunction`用于终止播放：
+	
+	1.	若为计分板播放器，则其中包含将**全体玩家的播放计分板**重置的指令。
+	
+	2.	若为延迟或中继器播放器，则其中包含**停用命令方块**和**启用命令方块**的指令。~~然鹅实际上对于播放而言是一点用也没有~~
+
+	>	你知道吗？音·创的最早期版本“《我的世界》函数音乐生成器”正是用函数来播放，不过这个版本采取的读入数据的形式大有不同。
+
+2. 生成结构的方式
+
+    无论是音·创生成的是何种结构，`MCSTRUCTURE`还是`BDX`，都会依照此处的格式来生成。此处我们想说明的结构的格式不是结构文件存储的格式，而是结构导出之后方块摆放的方式。结构文件存储的格式这一点，在各个《我的世界》开发的相关网站上都可能会有说明。
+
+	考虑到进行《我的世界》游戏开发时，为了节约常加载区域，很多游戏会将指令区设立为一种层叠式的结构。这种结构会限制每一层的指令系统的高度，但是虽然长宽也是有限的，却仍然比其纵轴延伸得更加自由。
+
+	所以，结构的生成形状依照给定的高度和内含指令的数量决定。其 $Z$ 轴延伸长度为指令方块数量对于给定高度之商的向下取整结果的平方根的向下取整。用数学公式的方式表达，则是：
+	
+	$$ MaxZ = \left\lfloor\sqrt{\left\lfloor{\frac{NoC}{MaxH}}\right\rfloor}\right\rfloor $$
+
+	其中，$MaxZ$ 即生成结构的$Z$轴最大延伸长度，$NoC$ 表示链结构中所含指令方块的个数，$MaxH$ 表示给定的生成结构的最大高度。
+
+	我们的结构生成器在生成指令链时，将首先以相对坐标系 $(0, 0, 0)$ （即相对原点）开始，自下向上堆叠高度轴（即 $Y$ 轴）的长，当高度轴达到了限制的高度时，便将 $Z$ 轴向正方向堆叠 $1$ 个方块，并开始自上向下重新堆叠，直至高度轴坐标达到相对为 $0$。若当所生成结构的 $Z$ 轴长达到了其最大延伸长度，则此结构生成器将反转 $Z$ 轴的堆叠方向，直至 $Z$ 轴坐标相对为 $0$。如此往复，直至指令链堆叠完成。
+	
+
+# 进度条自定义
+
+因为我们提供了可以自动转换进度条的功能，因此在这里给出进度条自定义参数的详细解释。
+
+一个进度条，明显地，有**固定部分**和**可变部分**来构成。而可变部分又包括了文字和图形两种（当然，《我的世界》里头的进度条，可变的图形也就是那个“条”了）。这一点你需要了解，因为后文中包含了很多这方面的概念需要你了解。
+
+进度条的自定义功能使用一个字符串来定义自己的样式，其中包含众多**标识符**来表示可变部分。
+
+标识符如下（注意大小写）：
+
+| 标识符   | 指定的可变量     |
+|---------|----------------|
+| `%%N`   | 乐曲名(即传入的文件名)|
+| `%%s`   | 当前计分板值     |
+| `%^s`   | 计分板最大值     |
+| `%%t`   | 当前播放时间     |
+| `%^t`   | 曲目总时长       |
+| `%%%`   | 当前进度比率     |
+| `_`     | 用以表示进度条占位|
+
+表示进度条占位的 `_` 是用来标识你的进度条的。也就是可变部分的唯一的图形部分。
+
+**样式定义字符串（基础样式）**的样例如下，这也是默认进度条的基础样式：
+
+```▶ %%N [ %%s/%^s %%% __________ %%t|%^t]```
+
+这是单独一行的进度条，当然你也可以制作多行的，如果是一行的，输出时所使用的指令便是 `title`，而如果是多行的话，输出就会用 `titleraw` 作为进度条字幕。
+
+哦对了，上面的只不过是样式定义，同时还需要定义的是可变图形的部分，也就是进度条上那个真正的“条”。
+
+对于这个我们就采用了固定参数的方法，对于一个进度条，无非就是“已经播放过的”和“没播放过的”两种形态，例如，我们默认的进度“条”（**可变样式**）的定义是这样的：
+
+**可变样式甲（已播放样式）**：`'§e=§r'`
+
+**可变样式乙（未播放样式）**：`'§7=§r'`
+
+综合起来，把这些参数传给函数需要一个参数整合，使用位于 `Musicreater/subclass.py` 下的 `ProgressBarStyle` 类进行定义：
+
+我们的默认定义参数如下：
+
+```python
+DEFAULT_PROGRESSBAR_STYLE = ProgressBarStyle(
+    r"▶ %%N [ %%s/%^s %%% __________ %%t|%^t ]",
+    r"§e=§r",
+    r"§7=§r",
+)
+```
+
+*为了避免生成错误，请尽量避免使用标识符作为定义样式字符串的其他部分*
+

docs/生成文件的使用说明.md

@@ -0,0 +1,56 @@
+<h1 align="center">音·创 Musicreater</h1>
+
+<p align="center">
+<img width="128" height="128" src="https://gitee.com/TriM-Organization/Musicreater/raw/master/resources/msctIcon.png" >
+</p>
+
+#	生成文件的使用
+
+*这是本库所生成文件的使用声明，不是使用本库的教程，若要查看**本库的文档**，可点击[此处](./%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md)；若要查看有关文件结构的内容，可以点击[此处](./%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E.md)*
+
+##	附加包格式
+
+支持的文件后缀：`.MCPACK`
+
+-	计分板播放器
+
+	1.	导入附加包
+	2.	在一个循环方块中输入指令 `function index`
+	3.	将需要聆听音乐的实体的播放所用计分板设置为 `1`
+	4.	激活循环方块
+	5.	若想要暂停播放，可以停止循环指令方块的激活状态
+	6.	若想要重置某实体的播放，可以将其播放用的计分板重置
+	7.	若要终止全部玩家的播放，在聊天框输入指令 `function stop`
+
+	>	其中 步骤三 和 步骤四 的顺序可以调换。
+
+-	延迟播放器
+
+	1.	导入附加包
+	2.	在聊天框输入指令 `function index`
+	3.	同时激活所生成的循环和脉冲指令方块
+	4.	若要终止播放，在聊天框输入指令 `function stop` 试试看，不确保有用
+	
+	> 需要注意的是，循环指令方块需要一直激活直到音乐结束
+
+##	结构格式
+
+支持的文件后缀：`.MCSTRUCTURE`、`.BDX`
+
+1.	将结构导入世界
+
+-	延迟播放器
+	
+	2.	将结构生成的第一个指令方块之模式更改为**脉冲**
+	3.	激活脉冲方块
+	4.	若欲重置播放，可以停止对此链的激活，例如停止区块加载
+	5.	此播放器不支持暂停
+
+-	计分板播放器
+
+	2.	在所生成的第一个指令方块前，放置一个循环指令方块，其朝向应当对着所生成的第一个方块
+	3.	在循环指令方块中输入使播放对象的播放用计分板加分的指令，延迟为 `0`，每次循环增加 `1` 分
+	4.	激活循环方块
+	5.	若想要暂停播放，可以停止循环指令方块的激活状态
+	6.	若想要重置某实体的播放，可以将其播放用的计分板重置
+

docs/转换乐器对照表.md

@@ -0,0 +1,222 @@
+<h1 align="center">音·创 Musicreater</h1>
+
+<p align="center">
+<img width="128" height="128" src="https://gitee.com/TriM-Organization/Musicreater/raw/master/resources/msctIcon.png" >
+</p>
+
+# 转换乐器对照表
+
+**_注意！本文档中的对照表，版权归属于音·创作者，并按照本仓库根目录下 LICENSE.md 中规定开源_**
+
+原表格请见[constant.py](../Musicreater/constants.py#176)
+
+**_使用时请遵循协议规定_**
+
+-   版权所有 © 2025 金羿 & 诸葛亮与八卦阵  
+-   Copyright © 2025 Eilles & bgArray  
+
+*   音·创（“本项目”）的协议颁发者为 金羿、诸葛亮与八卦阵  
+*   The Licensor of Musicreater("this project") is Eilles, bgArray.  
+
+本项目根据 第一版 汉钰律许可协议（“本协议”）授权。
+任何人皆可从以下地址获得本协议副本：https://gitee.com/EillesWan/YulvLicenses。
+若非因法律要求或经过了特殊准许，此作品在根据本协议“原样”提供的基础上，不予提供任何形式的担保、任何明示、任何暗示或类似承诺。也就是说，用户将自行承担因此作品的质量或性能问题而产生的全部风险。
+详细的准许和限制条款请见原协议文本。
+
+音·创 开发交流群 861684859\
+Email TriM-Organization@hotmail.com\
+若需转载或借鉴 许可声明请查看仓库根目录下的 License.md
+
+### 名词解释
+
+| 名词         | 说明                                                                                                                            |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| 音符名称     | 我的世界游戏内用于播放音乐的 `playsound` 指令所规定的 `Sound ID`                                                                |
+| 音调偏移参数 | 在《我的世界》中，不同乐器的音域不同，对应的 `pitch` 值也不尽相同，该参数的解释请参考[文档说明](库的生成与功能文档.md#参数释义) |
+
+# 乐音乐器
+
+对照表版本：2023 0527
+
+| Midi 乐器值 | 音符名称            | 音调偏移参数 |
+| ----------- | ------------------- | ------------ |
+| 0           | note.harp           | 6            |
+| 1           | note.harp           | 6            |
+| 2           | note.pling          | 6            |
+| 3           | note.harp           | 6            |
+| 4           | note.pling          | 6            |
+| 5           | note.pling          | 6            |
+| 6           | note.harp           | 6            |
+| 7           | note.harp           | 6            |
+| 8           | note.share          | 7            |
+| 9           | note.harp           | 6            |
+| 10          | note.didgeridoo     | 8            |
+| 11          | note.harp           | 6            |
+| 12          | note.xylophone      | 4            |
+| 13          | note.chime          | 4            |
+| 14          | note.harp           | 6            |
+| 15          | note.harp           | 6            |
+| 16          | note.bass           | 8            |
+| 17          | note.harp           | 6            |
+| 18          | note.harp           | 6            |
+| 19          | note.harp           | 6            |
+| 20          | note.harp           | 6            |
+| 21          | note.harp           | 6            |
+| 22          | note.harp           | 6            |
+| 23          | note.guitar         | 7            |
+| 24          | note.guitar         | 7            |
+| 25          | note.guitar         | 7            |
+| 26          | note.guitar         | 7            |
+| 27          | note.guitar         | 7            |
+| 28          | note.guitar         | 7            |
+| 29          | note.guitar         | 7            |
+| 30          | note.guitar         | 7            |
+| 31          | note.bass           | 8            |
+| 32          | note.bass           | 8            |
+| 33          | note.bass           | 8            |
+| 34          | note.bass           | 8            |
+| 35          | note.bass           | 8            |
+| 36          | note.bass           | 8            |
+| 37          | note.bass           | 8            |
+| 38          | note.bass           | 8            |
+| 39          | note.bass           | 8            |
+| 40          | note.harp           | 6            |
+| 41          | note.harp           | 6            |
+| 42          | note.harp           | 6            |
+| 43          | note.harp           | 6            |
+| 44          | note.iron_xylophone | 6            |
+| 45          | note.guitar         | 7            |
+| 46          | note.harp           | 6            |
+| 47          | note.harp           | 6            |
+| 48          | note.guitar         | 7            |
+| 49          | note.guitar         | 7            |
+| 50          | note.bit            | 6            |
+| 51          | note.bit            | 6            |
+| 52          | note.harp           | 6            |
+| 53          | note.harp           | 6            |
+| 54          | note.bit            | 6            |
+| 55          | note.flute          | 5            |
+| 56          | note.flute          | 5            |
+| 57          | note.flute          | 5            |
+| 58          | note.flute          | 5            |
+| 59          | note.flute          | 5            |
+| 60          | note.flute          | 5            |
+| 61          | note.flute          | 5            |
+| 62          | note.flute          | 5            |
+| 63          | note.flute          | 5            |
+| 64          | note.bit            | 6            |
+| 65          | note.bit            | 6            |
+| 66          | note.bit            | 6            |
+| 67          | note.bit            | 6            |
+| 68          | note.flute          | 5            |
+| 69          | note.harp           | 6            |
+| 70          | note.harp           | 6            |
+| 71          | note.flute          | 5            |
+| 72          | note.flute          | 5            |
+| 73          | note.flute          | 5            |
+| 74          | note.harp           | 6            |
+| 75          | note.flute          | 5            |
+| 76          | note.harp           | 6            |
+| 77          | note.harp           | 6            |
+| 78          | note.harp           | 6            |
+| 79          | note.harp           | 6            |
+| 80          | note.bit            | 6            |
+| 81          | note.bit            | 6            |
+| 82          | note.bit            | 6            |
+| 83          | note.bit            | 6            |
+| 84          | note.bit            | 6            |
+| 85          | note.bit            | 6            |
+| 86          | note.bit            | 6            |
+| 87          | note.bit            | 6            |
+| 88          | note.bit            | 6            |
+| 89          | note.bit            | 6            |
+| 90          | note.bit            | 6            |
+| 91          | note.bit            | 6            |
+| 92          | note.bit            | 6            |
+| 93          | note.bit            | 6            |
+| 94          | note.bit            | 6            |
+| 95          | note.bit            | 6            |
+| 96          | note.bit            | 6            |
+| 97          | note.bit            | 6            |
+| 98          | note.bit            | 6            |
+| 99          | note.bit            | 6            |
+| 100         | note.bit            | 6            |
+| 101         | note.bit            | 6            |
+| 102         | note.bit            | 6            |
+| 103         | note.bit            | 6            |
+| 104         | note.harp           | 6            |
+| 105         | note.banjo          | 6            |
+| 106         | note.harp           | 6            |
+| 107         | note.harp           | 6            |
+| 108         | note.harp           | 6            |
+| 109         | note.harp           | 6            |
+| 110         | note.harp           | 6            |
+| 111         | note.guitar         | 7            |
+| 112         | note.harp           | 6            |
+| 113         | note.bell           | 4            |
+| 114         | note.harp           | 6            |
+| 115         | note.cow_bell       | 5            |
+| 116         | note.bd             | 7            |
+| 117         | note.bass           | 8            |
+| 118         | note.bit            | 6            |
+| 119         | note.bd             | 7            |
+| 120         | note.guitar         | 7            |
+| 121         | note.harp           | 6            |
+| 122         | note.harp           | 6            |
+| 123         | note.harp           | 6            |
+| 124         | note.harp           | 6            |
+| 125         | note.hat            | 7            |
+| 126         | note.bd             | 7            |
+| 127         | note.snare          | 7            |
+
+# 打击乐器
+
+| Midi 打击乐器值 | 音符名称            | 音调偏移参数 |
+| --------------- | ------------------- | ------------ |
+| 34              | note.bd             | 7            |
+| 35              | note.bd             | 7            |
+| 36              | note.hat            | 7            |
+| 37              | note.snare          | 7            |
+| 38              | note.snare          | 7            |
+| 39              | note.snare          | 7            |
+| 40              | note.hat            | 7            |
+| 41              | note.snare          | 7            |
+| 42              | note.hat            | 7            |
+| 43              | note.snare          | 7            |
+| 44              | note.snare          | 7            |
+| 45              | note.bell           | 4            |
+| 46              | note.snare          | 7            |
+| 47              | note.snare          | 7            |
+| 48              | note.bell           | 4            |
+| 49              | note.hat            | 7            |
+| 50              | note.bell           | 4            |
+| 51              | note.bell           | 4            |
+| 52              | note.bell           | 4            |
+| 53              | note.bell           | 4            |
+| 54              | note.bell           | 4            |
+| 55              | note.bell           | 4            |
+| 56              | note.snare          | 7            |
+| 57              | note.hat            | 7            |
+| 58              | note.chime          | 4            |
+| 59              | note.iron_xylophone | 6            |
+| 60              | note.bd             | 7            |
+| 61              | note.bd             | 7            |
+| 62              | note.xylophone      | 4            |
+| 63              | note.xylophone      | 4            |
+| 64              | note.xylophone      | 4            |
+| 65              | note.hat            | 7            |
+| 66              | note.bell           | 4            |
+| 67              | note.bell           | 4            |
+| 68              | note.hat            | 7            |
+| 69              | note.hat            | 7            |
+| 70              | note.flute          | 5            |
+| 71              | note.flute          | 5            |
+| 72              | note.hat            | 7            |
+| 73              | note.hat            | 7            |
+| 74              | note.xylophone      | 4            |
+| 75              | note.hat            | 7            |
+| 76              | note.hat            | 7            |
+| 77              | note.xylophone      | 4            |
+| 78              | note.xylophone      | 4            |
+| 79              | note.bell           | 4            |
+| 80              | note.bell           | 4            |

docs/音乐序列文件格式.md

@@ -0,0 +1,149 @@
+# 音乐序列文件格式
+
+音·创 库的音符序列文件格式包含两种，一种是常规的音乐序列存储采用的 MSQ 格式，另一种是为了流式读取音符而采用的 FSQ 格式。
+
+## MSQ 数据格式
+
+MSQ 格式是 音·创 库存储音符序列的一种字节码格式，取自 **M**usic**S**e**Q**uence 类之名。
+
+现在 音·创 库及其上游软件使用的是在 第二版 的基础上增设校验功能的 MSQ 第三版。
+
+### MSQ 第三版
+
+第三版 MSQ 格式的码头是 `MSQ!` ，这一版中，所有的**字符串**皆以 _**GB18030**_ 编码进行编解码，**数值**皆是以 _**大端字节序**_ 存储的无符号整数。
+
+码头是字节码前四个字节的内容，这一部分内容是可读的 ASCII 字串。因此，第三版的字节码中前四个字节的内容必为 `MSQ!`。
+
+第二版 MSQ 取 `MSQ@` 作为码头是因为美式键盘上 @ 是 Shift+2 键 按下取得的，故代表 MSQ 第二版。
+
+你猜为什么第三版是 `MSQ!`。
+
+#### 元信息
+
+| 信息名称                       | 西文代号                   | 位长（多少个 0 或 1） | 支持说明                                                                                                                                                   |
+| ------------------------------ | -------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **码头**                       | _无_                       | 32 位                 | 值为 `MSQ!`                                                                                                                                                |
+| **音乐名称长度**               | music_name_length          | 6 位                  | 支持数值 0~63                                                                                                                                              |
+| **最小音量**                   | minimum_volume             | 10 位                 | 支持数值 0~1023，注意，这里每个 1 代表最小音量的 0.001 个单位，即取值是此处表示数字的千分倍                                                                |
+| **是否启用高精度音符时间控制** | enable_high_precision_time | 1 位                  | 1 是启用，反之同理                                                                                                                                         |
+| **总音调偏移**                 | music_deviation            | 15 位                 | 支持数值 -16383~16383，这里也是表示三位小数的，和最小音量一样。这里 15 位中的第一位（从左往右）是正负标记，若为 1 则为负数，反之为正数，后面的 14 位是数值 |
+| **音乐名称**                   | music_name                 | 依据先前定义          | 最多可支持 31 个中文字符 或 63 个西文字符，其长度取决于先前获知的 “音乐名称长度” 的定义                                                                    |
+
+在这一元信息中，**音乐名称长度**和**最小音量**合计共 2 字节；**高精度音符时间控制启用**和**总音调偏移**合计共 2 字节；因此，除**音乐名称**为任意长度，前四字节内容均为固定。
+
+#### 音符序列
+
+每个序列前 4 字节为一个用以表示当前通道中音符数量的值，也就是**通道音符数**（notes_count）。也即是说，一个通道内的音符可以是 0~4294967295 个。
+
+在这之后，就是这些数量的音符了，其中每个音符的信息存储方式如下
+
+| 信息名称                     | 西文代号                 | 位长                            | 支持说明                                                                                                                                                                            |
+| ---------------------------- | ------------------------ | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **乐器名称长度**             | name_length              | 6 位                            | 支持数值 0~63                                                                                                                                                                       |
+| **Midi 音高**                | note_pitch               | 7 位                            | 支持数值 0~127                                                                                                                                                                      |
+| **开始时刻**                 | start_tick               | 17 位                           | 单位 二十分之一秒，即约为 1 命令刻；支持数值 0~131071 即 109.22583 分钟 合 1.8204305 小时                                                                                           |
+| **音符持续刻数**             | duration                 | 17 位                           | 同上                                                                                                                                                                                |
+| **是否作为打击乐器**         | percussive               | 1 位                            | 1 是启用，反之同理                                                                                                                                                                  |
+| **响度（力度）**             | velocity                 | 7 位                            | 支持数值 0~127                                                                                                                                                                      |
+| **是否启用声像位移**         | is_displacement_included | 1 位                            | 1 是启用，反之同理                                                                                                                                                                  |
+| **时间精度提升值**（非必含） | high_time_precision      | 8 位                            | 支持数值 0~255，若在 元信息 中启用**高精度音符时间控制**，则此值启用，代表音符时间控制精度偏移，此值每增加 1，则音符开始时刻向后增加 1/1250 秒                                      |
+| **乐器名称**                 | sound_name               | 依据先前定义                    | 最多可支持 31 个中文字符 或 63 个西文字符，其长度取决于先前获知的 “乐器名称长度” 的定义                                                                                             |
+| **声像位移**（非必含）       | position_displacement    | 共三个值，每个值 16 位 共 48 位 | 若前述**是否启用声像位移**已启用，则此值启用；三个值分别代表 x、y、z 轴上的偏移，每个值支持数值 0~65535，注意，这里每个 1 代表最小音量的 0.001 个单位，即取值是此处表示数字的千分倍 |
+
+#### 序列校验
+
+_第三版新增_
+
+在每个音符序列结尾包含一个 128 位的校验值，用以标识该序列结束的同时，验证该序列的完整性。  
+在这 128 位里，前 64 位是该通道音符数的 XXHASH64 校验值，以 3 作为种子值。  
+后 64 位是整个通道全部字节串的 XXHASH64 校验值（包括通道开头的音符数），以 该通道音符数 作为种子值。
+
+#### 总体校验
+
+_第三版新增_
+
+在所有有效数据之后，包含一个 128 位的校验值，用以标识整个字节串结束的同时，验证整个字节码数据的完整性。
+
+该 128 位的校验值是 包括码头在内的元信息的 XXHASH64 校验值（种子值是全曲音符数） 对于前述所有校验值彼此异或的异或 所得值之 XXHASH128 校验值，以 全曲音符总数 作为种子值。
+
+请注意，是前述每个 XXHASH64 校验值的异或（每次取 XXHASH64 都计一遍），也就并非是每个序列结尾，那个已经合并了的 128 位校验值再彼此异或。对于这个异或值，再取其种子是 全曲音符数 的 XXHASH128 校验字节码。
+
+听起来很复杂？我来举个例子。以下是该算法的伪代码。我们设：
+
+-   `meta_info` : `bytes` 为 元信息字节串
+-   `note_seq_1` : `bytes` 为 第一个音符序列的编码字节串
+-   `note_seq_2` : `bytes` 为 第二个音符序列的编码字节串
+-   `XXH64(bytes, seed)` : `bytes` 为 XXHASH64 校验函数
+-   `XXH128(bytes, seed)` : `bytes` 为 XXHASH128 校验函数
+-   `XOR(bytesLike, bytesLike)` : `bytes` 为 异或 函数
+-   `note_count` : `int` 为 全曲音符数
+-   `seq_1_note_count` : `int` 为 第一个音符序列的音符数
+-   `seq_2_note_count` : `int` 为 第二个音符序列的音符数
+
+为了简化，我们假设只有两个序列，实际上每个通道都是一个序列（最多 16 个序列）
+
+那么，一个完整的 MSQ 文件应当如下排列其字节串：
+
+```assembly
+ADD meta_info
+ADD note_seq_1
+ADD XXH64(seq_1_note_count, 3)
+ADD XXH64(note_seq_1, seq_1_note_count)
+ADD note_seq_2
+ADD XXH64(seq_2_note_count, 3)
+ADD XXH64(note_seq_2, seq_2_note_count)
+ADD XXH128(
+        XOR(
+            XOR(
+                XXH64(meta_info, note_count),
+                XOR(
+                    XXH64(seq_1_note_count, 3),
+                    XXH64(note_seq_1, seq_1_note_count)
+                ),
+            ),
+            XOR(
+                XXH64(seq_2_note_count, 3),
+                XXH64(note_seq_2, seq_2_note_count),
+            )
+        ),
+        note_count
+    )
+```
+
+## FSQ 数据格式
+
+FSQ 格式是 音·创 库存储音符序列的一种字节码格式，取自 **F**lowing Music **S**e**q**uence 之名。
+
+现在 音·创 库及其上游软件使用的是在 MSQ 第三版 的基础上进行流式的兼容性变动。
+
+### FSQ 第一版
+
+第一版的码头是 `FSQ!` ，这一版中，所有的**字符串**皆以 _**GB18030**_ 编码进行编解码，**数值**皆是以 _**大端字节序**_ 存储的无符号整数。
+
+码头是字节串前四个字节的内容，这一部分内容是可读的 ASCII 字串。因此，这一版的文件前四个字节的内容必为 `FSQ!`。
+
+因为这一版本是在 MSQ 第三版的基础上演变而来的，因此取自 MSQ 码头的 `MSQ!` 而改作 `FSQ!`。
+
+#### 元信息
+
+FSQ 第一版的元信息是在 MSQ 第三版的元信息的基础上增加了一个占 5 字节的全曲音符总数。
+
+也就是说，与 MSQ 第三版一致的，在这一组信息中，**音乐名称长度**和**最小音量**合计共 2 字节；**高精度音符时间控制启用**和**总音调偏移**合计共 2 字节；因此，除**音乐名称**为任意长度，前四字节内容均为固定。而最后增加 5 字节作为全曲音符总数。
+
+#### 音符序列
+
+FSQ 格式不包含音符的通道信息，在读取处理时默认将同一乐器的音符视为同一通道。也就是说，仅存在一个序列。其中每个音符的信息存储方式与 MSQ 第三版一致。
+
+音符序列的存储顺序是按照音符的**开始时间**进行排序的。
+
+但是注意！有可能一个较长的音符的开始到结束时间内还包含有音符，此时如有要适配的读取器，还请继续读取直到下一个音符的开始时间大于此较长音符的结束时间。
+
+在每 100 个音符后，插入一段 32 位的 XXHASH32 校验码，其所校验的内容为这一百个音符中每个音符的第 6 个字节彼此异或之结果，种子值为这一百个音符中每个音符的第 2 个字节的彼此异或结果。
+
+若最后不满足 100 个音符，则不插入上述校验码。
+
+#### 总体校验
+
+在所有有效数据之后，包含一个 128 位的校验值，用以标识整个字节串结束的同时，验证整个字节码数据的完整性。
+
+该 128 位的校验值是 包括码头在内的元信息的 XXHASH64 校验值（种子值是全曲音符数） 对于前述所有 XXHASH32 校验值彼此异或的异或 所得值之 XXHASH128 校验值，以 全曲音符总数 作为种子值。

fcwslib/__init__.py

@@ -1,170 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：2个---未解决；警告（二级）错误：2个；语法（一级）错误：17个
-
-
-__version__ = '0.0.1'
-__all__ = []
-__author__ = 'Fuckcraft <https://gitee.com/fuckcraft>'
-
-'''
-Fuckcraft Websocket Library (FCWSLIB)
-A library to develop minecraft websocket server easily.
-
-    Copyright (C) 2021 Fuckcraft
-
-    This program is free software: you can redistribute it and/or modify
-    it under the terms of the GNU Affero General Public License as
-    published by the Free Software Foundation, either version 3 of the
-    License, or (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU Affero General Public License for more details.
-'''
-
-from main import *
-
-# import os
-import json
-import uuid
-# import logging
-import asyncio
-import time
-import websockets
-
-
-# 写这段代码的时候，只有我和上帝知道这段代码是干什么的。
-# 现在只有上帝知道。
-# ----
-# 没毛病，我讨厌两种人：一种是要我写注释的人，一种是给我代码看但没有写注释的人。
-
-# 此函数用于向 Minecraft 订阅请求
-async def subscribe(websocket, event_name):
-    """
-    参数:
-    : websocket  : websocket 对象 :
-    : event_name : 需要订阅的请求 :
-
-    返回:
-    None
-    """
-
-    response = {
-        'body': {
-            'eventName': str(event_name)  # 示例：PlayerMessage
-        },
-        'header': {
-            'requestId': str(uuid.uuid4()),
-            'messagePurpose': 'subscribe',
-            'version': 1,
-            'messageType': 'commandRequest'
-        }
-    }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-
-# 此函数用于向 Minecraft 消除订阅请求
-async def unsubscribe(webscket):
-    """
-    参数:
-    : websocket  : websocket 对象     :
-    : event_name : 需要消除订阅的请求 :
-
-    返回:
-    None
-    """
-    print(webscket)
-
-    response = {
-        "body": {
-            "eventName": str(event_name)  # PlayerMessage
-        },
-        "header": {
-            "requestId": str(uuid.uuid4()),
-            "messagePurpose": "unsubscribe",
-            "version": 1,
-            "messageType": "commandRequest"
-        }
-    }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-
-# 此函数用于向 Minecraft 执行命令
-async def send_command(websocket, command):
-    """
-    参数:
-    : websocket : websocket 对象 :
-    : command   : 执行的命令     :
-
-    返回:
-    None
-    """
-
-    response = {
-        'body': {
-            'origin': {
-                'type': 'player'
-            },
-            'commandLine': str(command),
-            'version': 1
-        },
-        'header': {
-            'requestId': str(uuid.uuid4()),
-            'messagePurpose': 'commandRequest',
-            'version': 1,
-            'messageType': 'commandRequest'
-        }
-    }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-
-# 此函数用于向 Minecraft 发送消息
-async def tellraw(websocket, message):
-    """
-    参数:
-    : websocket : websocket 对象 :
-    : message   : 发送的消息     :
-
-    返回:
-    None
-    """
-
-    command = {
-        'rawtext': [
-            {
-                'text': '[{}] {}'.format(time.asctime(), message)
-            }
-        ]
-    }
-
-    # 增加 json 可读性
-    # command = json.dumps(command, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    command = json.dumps(command)
-    command = 'tellraw @a {}'.format(command)
-
-    await send_command(websocket, command)
-
-
-def run_server(function):
-    # 修改 ip 地址和端口
-    start_server = websockets.serve(function, 'localhost', 8080)
-    asyncio.get_event_loop().run_until_complete(start_server)
-    asyncio.get_event_loop().run_forever()

fcwslib/main.py

@@ -1,160 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-
-__version__ = '0.0.1'
-__all__ = ['run_server', 'subscribe', 'unsubscribe', 'send_command', 'tellraw']
-__author__ = 'Fuckcraft <https://gitee.com/fuckcraft>'
-
-'''
-Fuckcraft Websocket Library (FCWSLIB)
-A library to develop minecraft websocket server easily.
-
-    Copyright (C) 2021 Fuckcraft
-
-    This program is free software: you can redistribute it and/or modify
-    it under the terms of the GNU Affero General Public License as
-    published by the Free Software Foundation, either version 3 of the
-    License, or (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU Affero General Public License for more details.
-'''
-
-import os
-import json
-import uuid
-import logging
-import asyncio
-import time
-import websockets
-
-# 写这段代码的时候，只有我和上帝知道这段代码是干什么的。
-# 现在只有上帝知道。
-
-# 此函数用于向 Minecraft 订阅请求
-async def subscribe(websocket, event_name):
-    '''
-    输入:
-    : websocket  : websocket 对象 :
-    : event_name : 需要订阅的请求 :
-
-    输出:
-    None
-    '''
-
-    response = {
-            'body': {
-                'eventName': str(event_name)  # 示例：PlayerMessage
-            },
-            'header': {
-                'requestId': str(uuid.uuid4()),
-                'messagePurpose': 'subscribe',
-                'version': 1,
-                'messageType': 'commandRequest'
-            }
-        }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-    
-    await websocket.send(response)
-
-# 此函数用于向 Minecraft 消除订阅请求
-async def unsubscribe(webscket):
-    '''
-    输入:
-    : websocket  : websocket 对象     :
-    : event_name : 需要消除订阅的请求 :
-
-    输出:
-    None
-    '''
-
-    response = {
-            "body": {
-                "eventName": str(event_name)  # 示例：PlayerMessage
-            },
-            "header": {
-                "requestId": str(uuid.uuid4()),
-                "messagePurpose": "unsubscribe",
-                "version": 1,
-                "messageType": "commandRequest"
-            }
-        }
-    
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-# 我个人不负责这块的质量，因为他们逼迫我违心的写了这段代码
-
-# 此函数用于向 Minecraft 执行命令
-async def send_command(websocket, command):
-    '''
-    输入:
-    : websocket : websocket 对象 :
-    : command   : 执行的命令     :
-
-    输出:
-    None
-    '''
-
-    response = {
-            'body': {
-                'origin': {
-                    'type': 'player'
-                },
-                'commandLine': str(command),
-                'version': 1
-            },
-            'header': {
-                'requestId': str(uuid.uuid4()),
-                'messagePurpose': 'commandRequest',
-                'version': 1,
-                'messageType': 'commandRequest'
-            }
-        }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-# 此函数用于向 Minecraft 发送消息
-async def tellraw(websocket, message):
-    '''
-    输入:
-    : websocket : websocket 对象 :
-    : message   : 发送的消息     :
-
-    输出:
-    None
-    '''
-
-    command = {
-            'rawtext':[
-                {
-                    'text':'[{}] {}'.format(time.asctime(), message)
-                }
-            ]
-        }
-
-    # 增加 json 可读性
-    # command = json.dumps(command, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    command = json.dumps(command)
-    command = 'tellraw @a {}'.format(command)
-
-    await send_command(websocket, command)
-
-def run_server(function):
-    # 修改 ip 地址和端口
-    start_server = websockets.serve(function, 'localhost', 8080)
-    asyncio.get_event_loop().run_until_complete(start_server)
-    asyncio.get_event_loop().run_forever()
-

languages/const2string.py

@@ -1,96 +0,0 @@
-# -*- coding:utf-8 -*-
-
-
-# W-YI 金羿
-# QQ 2647547478
-# 音·创 开发交流群 861684859
-# Email EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
-# 版权所有 Team-Ryoun 金羿
-# 若需转载或借鉴 请附作者
-
-
-"""
-   Copyright 2022 Eilles Wan (金羿)
-
-   Licensed under the Apache License, Version 2.0 (the 'License')
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an 'AS IS' BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-"""
-
-#  代码写的并非十分的漂亮，还请大佬多多包涵；本软件源代码依照Apache软件协议公开
-
-# -----------------------------分割线-----------------------------
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：12个
-# 目前我的Pycharm并没有显示任何错误，有错误可以向：
-# bgArray 诸葛亮与八卦阵
-# QQ 474037765 或最好加入：音·创 开发交流群 861684859
-# ------------------------- split line-----------------------------
-# Zhuge Liang and Bagua array help to modify the grammar date: -- January 19, 2022
-# Statistics: fatal (Level 3) errors: 0; Warning (Level 2) errors: 15; Syntax (Level 1) error: 597
-# At present, my Pycham does not display any errors. If there are errors, you can report them to me
-# Bgarray Zhuge Liang and Bagua array
-# QQ 474037765 or better join: Musicreater development exchange group 861684859
-# ------------------------- split line-----------------------------
-
-# 下面为正文
-
-
-# 将程序中用双引号""括起来的字符串
-# 转为字符串列表 list[str, str, ...]
-# 方便进行语言翻译支持。
-
-import sys
-startWith = 0
-
-
-def __main__():
-    textList = []
-    for fileName in sys.argv[1:]:
-        print('读取文件: {}'.format(fileName))
-        fileText = []
-        for line in open(fileName, 'r', encoding='utf-8'):
-            while line.count('"') >= 2:
-                # 只有上帝看得懂我在写什么。
-                if line[
-                   line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])] in textList:
-                    thisText = textList.index(
-                        line[line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])])
-                else:
-                    thisText = len(textList)
-                    textList.append(
-                        line[line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])])
-                line = line.replace(
-                    line[line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])],
-                    'READABLETEXT[{}]'.format(thisText + startWith)
-                )
-            fileText.append(line)
-
-        open(fileName + '_C', 'w', encoding='utf-8').writelines(fileText)
-
-    outFile = open('lang__.py', 'w', encoding='utf-8')
-    outFile.write('''# -*- coding:utf-8 -*-
-
-# 由金羿翻译工具生成字符串列表
-# 请在所需翻译文件前from 此文件 import READABLETEXT
-
-
-
-READABLETEXT = {
-''')
-    for i in range(len(textList)):
-        outFile.write("    {}:{},\n".format(i + startWith, textList[i]))
-    outFile.write('}')
-    outFile.close()
-
-
-if __name__ == '__main__':
-    __main__()

languages/enGB.py

@@ -1,180 +0,0 @@
-# -*- coding:utf-8 -*-
-
-# 由金羿翻译工具生成字符串列表
-# 请在所需翻译的文件前from 此文件 import READABLETEXT
-
-
-READABLETEXT = {
-    'Translator': (("Eilles Wan (金羿)", True),),
-    # 此处是语言翻译者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    0: "ERROR❌",
-    1: "TIPS❗",
-    2: "Clearing log(this wont be in the file)",
-    3: "Could not clear the temporary files or logs",
-    4: "saved",
-    5: "New Musicreater Project",
-    6: "Select old-type project",
-    7: "Select Musicreater Project",
-    8: "Cant open:{}, please check if youve entered the right name",
-    9: "Musicreat - About",
-    10: "Musicreater",
-    11: "Ver. {}",
-    12: """Team-Ryoun for Minecraft\n×\nTeam-Ryoun for Software Development""",
-    13: "OK",
-    14: "Inpute Notes",
-    15: (("- Developers -", False),
-         ("Eilles Wan (金羿)", True), ("EillesWan@outlook.com", False), ("QQ 2647547478", False),
-         ("bgArray “诸葛亮与八卦阵”", True), ("QQ 474037765", False)),
-    # 此处是开发者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    16: "- Translators -",
-    # 17:"",
-    18: "QQ Group: 861684859",
-    19: "Musicreater - Help",
-    20: "Select sound file",
-    21: "Select MIDI file",
-    22: "Select NoteText file",
-    23: "Get Note info",
-    24: "Write in Note info: {}",
-    25: "Select generating file",
-    26: "Select generating folder",
-    27: "Select generating .mcpack file",
-    28: "Input position info",
-    29: "Select generating world folder",
-    30: "Select generating Function Pack",
-    31: "Select .mcfunction file ",
-    32: "Select .bdx file ",
-    33: "DONE✔",
-    34: "Input playing rate",
-    35: "Generating",
-    36: "Select a world folder",
-    37: "Make sure",
-    38: "Generate .RyStruct file",
-    39: "FAILED❌",
-    40: "Report message inpution",
-    41: "Musicreater - {}",
-    42: "ExecutingEntityName: {}",
-    43: "ScoreboardName: {}",
-    44: "Instrument: {}",
-    45: "TrackName: {}",
-    46: "PackName: {}",
-    47: "MusicTitle: {}",
-    48: "IsRepeat?: {}",
-    49: "Player'sTargetSelector: {}",
-    50: "Modify Main Option",
-    51: "Modify Track Option",
-    52: "Default Instrument: Enter English\n",
-    53: "Open...",
-    54: "Open Old Project...",
-    55: "Save",
-    56: "Save as...",
-    57: "Exit",
-    58: "File",
-    59: "Load tracks from sound",
-    60: "Load tracks from Midi",
-    61: "Load tracks from Text",
-    62: "Input notes to track",
-    63: "Edit",
-    64: "Generate file...",
-    65: "Generate function pack...",
-    66: "Generate .mcpack file...",
-    67: "Functions(Pack)",
-    68: "Save music as blocks into a map",
-    69: "Save music as blocks into a exist map...",
-    70: "Save music as commands into a map",
-    71: "Save music as commands into a exist map...",
-    72: "Save music as notebox into a map",
-    73: "Save music as notebox into a exist map...",
-    74: "World",
-    75: "Generate a function that fits current music...",
-    76: "Export selected track as commands in .bdx...",
-    77: "Export .bdx file from map...",
-    78: "Export .RyStruct file from map...",
-    79: "Load functions into a world...",
-    80: "Separate long .mcfunction file into small ones and set them into a world as a chain...",
-    81: "Additional Functions",
-    82: "Show generating result",
-    83: "Set a websocket server on localhost:8080 and play the selected track",
-    84: "Experimental Functions",
-    85: "Clear log file",
-    86: "Clear save file(obsolete)",
-    87: "Help",
-    88: "About",
-    89: "Send a bug report",
-    90: "Q&A",
-    91: "Main Options",
-    92: "Export music as .BDX...",
-    93: "请输入指令链生成最高相对高度(≥5)",
-    94: "❌You should input a number which is not lower then 4, please reinput again.",
-    95: "Structure",
-    96: "Reset Main Options",
-    97: "Track Options",
-    # 98:"",
-    # 99:"",
-    # 100:"",
-    # 101:"",
-    102: "Delete Selected Track",
-    # 103:"",
-    # 104:"",
-
-    105: "Error with finding or reading file😢：{}",
-    106: "Project is unsaved, save before close?",
-    107: "Saved in: {}",
-    108: ("Musicreater 0.0.X Project","Musicreater 0.1+ Project","Musicreater 0.1+ TESTver Project"),
-    109: "Any Type",
-    110: "NoteFunCreater Project",
-    111: "MMFM (V0.0.6) Project",
-    112: "All Types",
-    113: ".MP3 file(piano sound)",
-    114: "Midi file",
-    115: "Text file",
-    116: "Position Inpution",
-    117: "Format Error❌, please Reinput!",
-    118: ".MCFUNCTION",
-    119: "The position of the ChainCB for execution:",
-    # 120: "",
-    121: "您的函数文件不大于一万条指令，无需进行分割操作。",
-    122: "请输入执行链生成相对坐标：",
-    123: "FastBuilder Structure",
-    124: "Done!\n{}",
-    125: "一秒，音乐走几拍？",
-    126: "按下确认后，在游戏中使用connect指令连接localhost:8080，即可播放",
-    127: "请输入区域选择的开始坐标：",
-    128: "请输入区域选择的结束坐标：",
-    129: "Whether air block remain when export?",
-    130: "Musicreater Structure",
-    131: "Done😃\n{}",
-    132: "Failed❌\n{}\n{}",
-    133: "Have not developed yet...",
-    134: "Your name",
-    135: "Your contact",
-    136: "Your description of Problem",
-    137: "Log file will be cleared when you exit.",
-    138: "Log file will NOT be cleared when you exit.",
-    139: "修改包名",
-    140: "修改音乐标题",
-    141: "修改玩家选择器\n注意！要加上中括号“[]”",
-    142: "修改本音轨的执行实体名",
-    143: "修改本音轨所用的积分板",
-    144: "修改本音轨所用乐器",
-    145: "您输入的乐器并非游戏内置乐器，是否继续用您输入的字符作为乐器？",
-    146: "修改本音轨生成的文件名",
-    # -----2022.1.25更新
-    147: "生成新文件至...",
-    148: "从midi导入音轨且用新方法解析",
-    149: "Open New: Musicreater Project...",
-    150: "保存为新项目",
-    151: "另存为新项...",
-    152: "（开发调试）关闭本次日志记录",
-    153: "生成新函数包至...",
-    154: "生成新函数附加包文件至...",
-    155: "生成新函数附加包文件，并将神羽资源包以散包形式放置至...",
-    156: "Select [MiraclePlumeResourcePack]...",
-    157: "没有路径文件(.rpposi文件)，请仔细阅读Readme或先试用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 方法添加路径文件吧！",
-    158: "有路径文件(.rpposi文件)，但路径指示错误，请仔细阅读Readme或先用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 更改路径！",
-    159: "更改路径文件(.rpposi文件)成功！！",
-    160: "从midi导入音轨且用类方法解析",
-    161: "打开 类方法： 音·创项目...",
-    162: "保存为类方法项目",
-    163: "另存为类方法项...",
-
-}

languages/lang.py

@@ -1,20 +0,0 @@
-# -*- coding:utf-8 -*-
-
-
-DEFAULTLANGUAGE = 'zh-CN'
-
-LANGUAGELIST = {
-    'zh-CN': (
-        "简体中文 中国大陆",
-        "Simplified Chinese, China Mainland",
-    ),
-    'en-GB': (
-        "英式英语 大不列颠",
-        "British English, Great Britain",
-    ),
-}
-
-if DEFAULTLANGUAGE == 'zh-CN':
-    from languages.zhCN import READABLETEXT
-elif DEFAULTLANGUAGE == 'en-GB':
-    from languages.enGB import READABLETEXT

languages/zhCN.py

@@ -1,185 +0,0 @@
-# -*- coding:utf-8 -*-
-
-# 由金羿翻译工具生成字符串列表
-# 请在所需翻译文件前from 此文件 import READABLETEXT
-
-
-READABLETEXT = {
-    'Translator': (("金羿 Eilles 原稿", True),),
-    # 此处是语言翻译者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    0: "错误❌",
-    1: "提示❗",
-    2: "清除log（此句不载入日志）",
-    3: "无法清除日志及临时文件",
-    4: "已存储",
-    5: "新建 音·创 项目",
-    6: "请选择旧类型的项目",
-    7: "请选择 音·创 项目",
-    8: "无法打开文件：{}，请查看您是否输入正确",
-    9: "音·创 - 关于",
-    10: "音·创 Musicreater",
-    11: "当前版本：{}",
-    12: """凌云我的世界开发团队\n×\n凌云计算机应用软件开发团队""",
-    13: "确定",
-    14: "请输入音符",
-    15: (("- 开发者 -", False),
-         ("金羿 Eilles", True), ("EillesWan@outlook.com", False), ("QQ 2647547478", False),
-         ("bgArray “诸葛亮与八卦阵”", True), ("QQ 474037765", False),
-         ),
-    # 此处是开发者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    16: "- 翻译者 -",
-    # 17:"",
-    18: "讨论群: 861684859",
-    19: "音·创 - 帮助",
-    20: "请选择钢琴声音的音乐文件",
-    21: "请选择 MIDI 文件",
-    22: "请选择 音符文本 文件",
-    23: "获取音符信息",
-    24: "音符数据写入{}",
-    25: "请选择文件生成的位置",
-    26: "请选择文件夹生成的位置",
-    27: "请选择.mcpack文件生成的位置",
-    28: "坐标信息输入",
-    29: "请选择世界文件夹生成的位置",
-    30: "请选择函数包生成的位置",
-    31: "请选择 .mcfunction 文件",
-    32: "请选择需要生成的.bdx文件",
-    33: "完成✔",
-    34: "输入播放速度",
-    35: "创建中",
-    36: "请选择世界文件夹所在的位置",
-    37: "请确认",
-    38: "生成.RyStruct文件",
-    39: "失败❌",
-    40: "邮件反馈信息输入",
-    41: "音·创 - {}",
-    42: "执行实体名：{}",
-    43: "使用计分板：{}",
-    44: "所用的乐器：{}",
-    45: "当前音轨名：{}",
-    46: "包名：{}",
-    47: "音乐标题：{}",
-    48: "是否重复：{}",
-    49: "玩家选择器：{}",
-    50: "修改主设置",
-    51: "修改节设置",
-    52: "游戏内置乐器如下：请输入英文\n",
-    53: "打开音·创项目...",
-    54: "打开旧项目...",
-    55: "保存项目",
-    56: "另存为...",
-    57: "退出",
-    58: "文件",
-    59: "从钢琴MP3导入音轨",
-    60: "从midi导入音轨",
-    61: "从文本文件导入音轨",
-    62: "输入音符至音轨",
-    63: "编辑",
-    64: "生成文件至...",
-    65: "生成函数包至...",
-    66: "生成附加包文件至...",
-    67: "函数(包)",
-    68: "将音乐以方块存储生成地图",
-    69: "将音乐以方块存储载入地图…",
-    70: "将音乐以指令存储生成地图",
-    71: "将音乐以指令存储载入地图…",
-    72: "将音乐以音符盒存储生成地图",
-    73: "将音乐以音符盒存储载入地图…",
-    74: "世界",
-    75: "生成符合当前音乐的函数播放器…",
-    76: "将选中音轨以指令存储生成.bdx文件…",
-    77: "由地图导出至.bdx文件…",
-    78: "由地图导出至.RyStruct文件…",
-    79: "将函数载入世界…",
-    80: "将大函数分割并建立执行链…",
-    81: "辅助功能",
-    82: "展示生成结果",
-    83: "建立位于localhost:8080上的websocket服务器播放选中音轨",
-    84: "实验性功能",
-    85: "清除日志文件",
-    86: "清除早期版本的存储文件",
-    87: "帮助",
-    88: "关于",
-    89: "发送错误日志反馈",
-    90: "帮助与疑问",
-    91: "音乐总设置(项目设置)",
-    # =============================================================此处有新增
-    92: "将音乐导出为BDX",
-    93: "请输入指令链生成最高相对高度(≥5)",
-    94: "您输入的数据有误❌，相对高度请输入一个不小于4的值，请重新输入。",
-    95: "结构操作",
-    96: "重置项目设置",
-    97: "当前音轨设置(段落设置)",
-    # 98:"",
-    # 99:"",
-    # 100:"",
-    # 101:"",
-    102: "删除选中音轨",
-    # 103:"",
-    # 104:"",
-    105: "找不到或无法读取文件😢：{}",
-    106: "您当前的项目已修改但未存储，是否先保存当前项目？",
-    107: "项目已经存储至：{}",
-    108: ("音·创0.0.X工程文件", "音·创0.1+工程文件", "音·创0.1+TEST工程文件"),
-    109: "任意类型",
-    110: "函数音创工程文件",
-    111: "MMFM0.0.6版本工程文件",
-    112: "全部类型",
-    113: "钢琴声音的音频文件",
-    114: "Midi文件",
-    115: "文本文件",
-    116: "请输入坐标：",
-    117: "您输入的格式有误❌，请重新输入。",
-    118: "我的世界指令函数文件",
-    119: "请输入执行链生成坐标：",
-    # 120: "",
-    121: "您的函数文件不大于一万条指令，无需进行分割操作。",
-    122: "请输入执行链生成相对坐标：",
-    123: "FastBuilder结构文件",
-    124: "转换结束！\n{}",
-    125: "一秒，音乐走几拍？",
-    126: "按下确认后，在游戏中使用connect指令连接localhost:8080，即可播放",
-    127: "请输入区域选择的开始坐标：",
-    128: "请输入区域选择的结束坐标：",
-    129: "所选区块导出时是否需要保留空气方块？",
-    130: "音·创结构文件",
-    131: "文件已生成\n{}",
-    132: "文件无法生成\n{}\n{}",
-    133: "本功能尚未开发。",
-    134: "您的称呼",
-    135: "您的联系方式",
-    136: "您对问题的描述",
-    137: "在程序结束后将清除日志及临时文件信息。",
-    138: "在程序结束后将不会清除日志及临时文件信息。",
-    139: "修改包名",
-    140: "修改音乐标题",
-    141: "修改玩家选择器\n注意！要加上中括号“[]”",
-    142: "修改本音轨的执行实体名",
-    143: "修改本音轨所用的积分板",
-    144: "修改本音轨所用乐器",
-    145: "您输入的乐器并非游戏内置乐器，是否继续用您输入的字符作为乐器？",
-    146: "修改本音轨生成的文件名",
-    # -----2022.1.25更新
-    147: "生成乐器文件至...",
-    148: "从midi导入音轨且用新方法解析",
-    # 149: "打开 新： 音·创项目...",
-    # 150: "保存为新项目",
-    # 151: "另存为新项...",
-    152: "（开发调试）关闭本次日志记录",
-    153: "生成乐器函数包至...",
-    154: "生成乐器函数附加包文件至...",
-    155: "生成乐器函数附加包文件，并将神羽资源包以散包形式放置至...",
-    156: "[神羽资源包位置选择]：选择文件夹...",
-    157: "没有路径文件(.rpposi文件)，请仔细阅读Readme或先试用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 方法添加路径文件吧！",
-    158: "有路径文件(.rpposi文件)，但路径指示错误，请仔细阅读Readme或先用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 更改路径！",
-    159: "更改路径文件(.rpposi文件)成功！！",
-    160: "从midi导入音轨且用类方法解析",
-    # 161: "打开 类方法： 音·创项目...",
-    # 162: "保存为类方法项目",
-    # 163: "另存为类方法项...",
-    164: "生成新文件至...",
-    165: "生成新函数包至...",
-    166: "生成新函数附加包文件至...",
-    167: "！！！这个midi文件读取不了，mido解析报错！！！"
-
-}

msctspt/bdxOpera_CP.py

@@ -1,221 +0,0 @@
-import os
-import brotli
-
-'''感谢由 Charlie_Ping “查理平” 带来的bdx转换代码'''
-
-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：7个
-
-
-class BdxConverter:
-    __header = "BD@"
-    __bin_header = b"BDX"
-    __generator_author = b"&Charlie_Ping"
-
-    keys = {
-        # x--, x++, addSmallX(-128~127), addX(-32768~32767), addBigX(-2147483648~2147483647)
-        "x": [b"\x0f", b"\x0e", b"\x1c", b"\x14", b"\x15"],
-        "y": [b"\x11", b"\x10", b"\x1d", b"\x16", b"\x17"],
-        "z": [b"\x13", b"\x12", b"\x1e", b"\x18", b"\x19"],
-        "end": b"\x58",
-        "isSigned": b"\x5a",
-        "placeCommandBlockWithData": b"\x1b",
-        "placeBlock": b"\x07"
-    }
-
-    def __init__(self, file_path: str, author: str, blocks):
-        self.author = author
-        self.blocks = blocks
-        self.file_path = file_path
-        self.direction = [0, 0, 0]
-        self.block_type = self.get_block_type
-        self.__file = self.create_and_upload_file
-
-    @property
-    def get_block_type(self):
-        """
-        blocks
-        [
-            {
-                "direction": [x: int, y: int, z: int],
-                block_name: str,
-                particular_value: int,
-            }
-        ]
-        :return: list 给出的所有方块种类名称
-        """
-        block_type = set()
-        for block_ in self.blocks:
-            block_type.add(block_["block_name"])
-        block_type = list(block_type)
-        return block_type
-
-    @property
-    def create_and_upload_file(self):
-        """
-        （瞎用property？ 害怕
-        创建一个bdx文件
-        要close！
-        :return: 一个文件对象
-        """
-        _dir = os.path.dirname(self.file_path)
-        if not os.path.isdir(_dir):
-            os.makedirs(_dir)
-        _bytes = self.__bin_header
-        _bytes += b"\x00"
-        _bytes += self.author.encode("utf-8") + self.__generator_author
-        for i in self.block_type:
-            _bytes += b"\x00\x01"
-            _bytes += bytes(i, encoding="utf-8")
-        _bytes += b"\x00"
-        _bytes += self.upload_blocks()
-        _bytes += b"X"
-        with open(self.file_path, "w+") as f:
-            f.write("BD@")
-            f.close()
-        with open(self.file_path, "ab+") as f:
-            f.write(brotli.compress(_bytes))
-            f.close()
-        return
-
-    def upload_blocks(self):
-        """
-        计算差值
-        写入移动过程
-        写入方块
-        更新差值
-        :return:
-        """
-        _types = b""
-        for block_ in self.blocks:
-            # print(f"当前方块：{block['block_name']}, 位置： {block['direction']}]")
-            diff = self.move_pointer(self.direction, block_["direction"])
-            _types += diff
-            if block_["block_name"] in ["command_block",
-                                        "chain_command_block",
-                                        "repeating_command_block"]:
-                _types += self.obtain_command_block(block_)
-            else:
-                _types += self.obtain_universal_block(block_)
-            self.direction = block_["direction"]
-        return _types
-
-    def move_pointer(self, direction: list, new_direction):
-        """
-        给出 两个[x, y, z]坐标，返回pointer的移动过程
-        :param direction: 坐标 1
-        :param new_direction: 坐标 2
-        :return: bytes
-        """
-        _bytes = b""
-        for i, sign in enumerate(["x", "y", "z"]):
-            # print(f"<{sign}> 新-旧={new_direction[i]-direction[i]}")
-            distance = new_direction[i] - direction[i]
-            if distance == 0:
-                # print("距离是0？跳过了")
-                continue
-            _bytes += self.obtain_pointer_type(distance, sign)
-            # print(f"向 {sign} 运动了 {distance} 格子")
-        return _bytes
-
-    @classmethod
-    def obtain_pointer_type(cls, num: int, coordinate: str):
-        """
-
-        用于确定辅助玩家以某一数据类型走指定长度
-
-        -1 -> 0
-        1 -> 1
-        [128, 127] -> 2
-        [-32768, 32767] -> 3
-        [-2147483648, 2147483647] -> 4
-        :param num:
-        :param coordinate: 坐标轴种类，x y 或 z
-        :return:
-        """
-        if num == 0:
-            return
-        pointer = 0
-        condition = (num != -1,  # byte=0, pointer=1
-                     num < -1 or num > 1,  # byte=1, pointer=2
-                     num < -128 or num > 127,  # byte=2, pointer=3
-                     num < -32768 or num > 32767,  # byte=4, pointer=4
-                     )
-        for i in condition:
-            if i:
-                pointer += 1
-        pointer_type = cls.keys[coordinate][pointer]
-
-        byte_len = 2 ** (pointer - 2)
-        if byte_len >= 1:
-            num_byte = num.to_bytes(byte_len, byteorder="big", signed=True)
-            return pointer_type + num_byte
-        return pointer_type
-
-    def obtain_universal_block(self, block1):
-        """
-        给定一个方块， 返回此方块在这个bdx中的id和方块data
-        :param block1: {block_name: str,particular_value: int}
-        :return: bytes
-        """
-        block_id = b"\x07" + self.block_type.index(block1["block_name"]).to_bytes(2, byteorder="big", signed=False)
-        particular_value = block1["particular_value"].to_bytes(2, byteorder="big", signed=False)
-        block_header = block_id + particular_value
-        return block_header
-
-    def obtain_command_block(self, block1):
-        """
-        给定一个命令方块，返回命令方块各种数据
-        :param block1: {
-            "direction": [x: int, y: int, z: int]
-            "block_name": str,
-            "particular_value": int,
-            "impluse": int,  # unsigned_int32
-            "command": str,
-            "customName": str,
-            "lastOutput": str,  # 没特殊要求写个\x00就得了
-            "tickdelay": int,  # int32
-            "executeOnFirstTick": int,  # 1 bytes
-            "trackOutput": int,  # 1 bytes
-            "conditional": int,  # 1 bytes
-            "needRedstone": int  # 1 bytes
-        }
-        :return: bytes of command_block
-        """
-
-        block_id = b"\x1b" + self.block_type.index(block1["block_name"]).to_bytes(2, byteorder="big", signed=False)
-        particular_value = block1["particular_value"].to_bytes(2, byteorder="big", signed=False)
-        block_header = block_id + particular_value
-        for i in [
-            block1["impluse"].to_bytes(4, byteorder="big", signed=False),
-            bytes(block1["command"], encoding="utf-8") + b"\x00",
-            bytes(block1["customName"], encoding="utf-8") + b"\x00",
-            bytes(block1["lastOutput"], encoding="utf-8") + b"\x00",
-            block1["tickdelay"].to_bytes(4, byteorder="big", signed=True),
-            block1["executeOnFirstTick"].to_bytes(1, byteorder="big"),
-            block1["trackOutput"].to_bytes(1, byteorder="big"),
-            block1["conditional"].to_bytes(1, byteorder="big"),
-            block1["needRedstone"].to_bytes(1, byteorder="big")
-        ]:
-            block_header += i
-        return block_header
-
-
-if __name__ == '__main__':
-    block = [{"direction": [-1, -1, -1], "block_name": "concrete", "particular_value": 5},
-             {"direction": [1, 5, 1], "block_name": "stained_glass", "particular_value": 7},
-             {"direction": [2, 4, 1], "block_name": "command_block", "particular_value": 3,
-              "impluse": 0,
-              "command": "say A generator test",
-              "customName": "test",
-              "lastOutput": "",
-              "tickdelay": 24,
-              "executeOnFirstTick": 0,
-              "trackOutput": 0,
-              "conditional": 0,
-              "needRedstone": 1
-              },
-             {"direction": [3, 4, 1], "block_name": "concrete", "particular_value": 6},
-             {"direction": [-123412133, 4, 1], "block_name": "concrete", "particular_value": 7}]
-    bdx = BdxConverter("./test02.bdx", "Charlie_Ping", block)

msctspt/bugReporter.py

@@ -1,137 +0,0 @@
-# -*- coding: UTF-8 -*-
-"""提供错误报告的基本操作及方法 顺便提供版本更新、安装库等功能"""
-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：1个；语法（一级）错误：72个
-import os
-import zipfile
-
-
-def makeZip(sourceDir, outFilename, compression=8, exceptFile=None):
-    """使用compression指定的算法打包目录为zip文件\n
-    默认算法为DEFLATED(8),可用算法如下：\n
-    STORED = 0\n
-    DEFLATED = 8\n
-    BZIP2 = 12\n
-    LZMA = 14\n
-    """
-    zipf = zipfile.ZipFile(outFilename, 'w', compression)
-    pre_len = len(os.path.dirname(sourceDir))
-    for parent, dirnames, filenames in os.walk(sourceDir):
-        for filename in filenames:
-            if filename == exceptFile:
-                continue
-            print(filename)
-            pathfile = os.path.join(parent, filename)
-            arcname = pathfile[pre_len:].strip(os.path.sep)  # 相对路径
-            zipf.write(pathfile, arcname)
-
-    zipf.close()
-    del zipf, pre_len
-
-
-# 以上函数节选并修改自 正在攀登的小蜗牛 的博客：https://blog.csdn.net/qq_21127151/article/details/107503942
-
-
-class report:
-    """发送报告以及相应的任务处理"""
-
-    def __init__(self, senderName: str = 'Unknown', senderContact: str = 'None', describetion: str = ''):
-        """:param senderName 发送者名称
-        :param senderContact 发送者联系方式
-        :param describetion 问题描述"""
-        self.senderName = senderName
-        self.senderContact = senderContact
-        self.describetion = describetion
-        if not self.senderName:
-            self.senderName = 'Unknown'
-        if not self.senderContact:
-            self.senderContact = 'None'
-
-    def emailReport(self):
-        """使用E-mail方法发送当前的日志和临时文件等"""
-        import smtplib
-        from email.mime.text import MIMEText
-        from email.mime.multipart import MIMEMultipart
-        from email.header import Header
-        from nmcsup.log import log
-        log("发送错误报告")
-        import os
-        log("添加标题与正文")
-        msg = MIMEMultipart()
-        # 发送者与接收者显示名称
-        msg["From"] = Header(self.senderName, 'utf-8')
-        msg["To"] = Header("W-YI (QQ2647547478)", 'utf-8')
-        # 标题
-        msg["Subject"] = '音·创 - 来自 ' + self.senderName + ' 的错误报告'
-        # 正文
-        msg.attach(
-            MIMEText("来自" + self.senderName + "( " + self.senderContact + " )的错误描述：\n" + self.describetion,
-                     'utf-8'))
-        log("添加完毕，正在生成压缩包...")
-        makeZip("./", "Temps&Logs.zip", exceptFile="Temps&Logs.zip")
-        attafile = MIMEText(str(open("Temps&Logs.zip", 'rb').read()), "base64", 'gb2312')
-        attafile["Content-Type"] = 'application/octet-stream'
-        attafile["Content-Disposition"] = 'attachmentfilename="BugReport_from_' + self.senderName + '.zip"'
-        msg.attach(attafile)
-        log("完毕，准备发送")
-        try:
-            smtp = smtplib.SMTP()
-            smtp.connect("smtp.163.com")
-            # smtp.login("RyounDevTeam@163.com","RyounDaiYi99")
-            # SIQQKQQYCZRVIDFJ是授权密码
-            smtp.login("RyounDevTeam@163.com", "SIQQKQQYCZRVIDFJ")
-            smtp.sendmail("RyounDevTeam@163.com", ["RyounDevTeam@163.com", ], msg.as_string())
-            log("错误汇报邮件已发送")
-        except smtplib.SMTPException as e:
-            log("错误汇报邮件发送失败：\n" + str(e))
-        log("清空内存和临时文件")
-        del msg, attafile
-        os.remove("./Temps&Logs.zip")
-
-
-class version:
-    libraries = (
-        'mido', 'amulet', 'amulet-core', 'amulet-nbt', 'piano_transcription_inference', 'pypinyin',
-        'pyinstaller','py7zr','websockets', 'torch'
-        )
-    """当前所需库，有一些是开发用的，用户不需要安装"""
-
-    version = ('0.1.5.1', 'Delta',)
-    """当前版本"""
-
-    def __init__(self) -> None:
-
-        self.libraries = version.libraries
-        """当前所需库，有一些是开发用的，用户不需要安装"""
-
-        self.version = version.version
-        """当前版本"""
-        
-
-    def installLibraries(self,index:str = 'https://pypi.tuna.tsinghua.edu.cn/simple'):
-        """安装全部开发用库"""
-        from sys import platform
-        import os
-        if platform == 'win32':
-            import shutil
-            try:
-                shutil.rmtree(os.getenv('APPDATA') + '\\Musicreater\\')
-            except FileNotFoundError:
-                pass
-            for i in self.libraries:
-                print("安装库：" + i)
-                os.system(f"python -m pip install {i} -i {index}")
-        elif platform == 'linux':
-            os.system("sudo apt-get install python3-pip")
-            os.system("sudo apt-get install python3-tk")
-            os.system("sudo apt-get install python3-tkinter")
-            for i in self.libraries:
-                print("安装库：" + i)
-                os.system(f"sudo python3 -m pip install {i} -i {index}")
-    
-
-    def __call__(self):
-        '''直接安装库，顺便返回一下当前版本'''
-        self.installLibraries()
-        return self.version

msctspt/funcOpera.py

@@ -1,396 +0,0 @@
-# -*- coding: utf-8 -*-
-"""音·创 的函数操作和一些其他功能"""
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：91个
-
-
-from nmcsup.log import log
-
-
-def delPart(Data, starter, ender, includeStart: bool = True, includend: bool = True):
-    """删除序列从starter物件到ender物件之间的部分\n
-    includeStart与inclodend分别控制此函数是否包括starter和ender物件所在部分，默认为真\n
-    starter与ender若为None则默认从首或尾开始"""
-    try:
-        if starter is None:
-            includeStart = True
-            starter = Data[0]
-        if ender is None:
-            includend = True
-            ender = Data[len(Data) - 1]
-        if includend:
-            if includeStart:
-                return Data[Data.index(starter):len(Data) - Data[len(Data)::-1].index(ender)]
-            else:
-                return Data[Data.index(starter) + 1:len(Data) - Data[len(Data)::-1].index(ender)]
-        else:
-            if includeStart:
-                return Data[Data.index(starter):len(Data) - Data[len(Data)::-1].index(ender) - 1]
-            else:
-                return Data[Data.index(starter) + 1:len(Data) - Data[len(Data)::-1].index(ender) - 1]
-    except:
-        return 0
-
-
-def keepart(Data, starter, ender, includeStart: bool = True, includend: bool = True):
-    """保留序列从starter物件到ender物件之间的部分\n
-    includeStart与inclodend分别控制此函数是否包括starter和ender物件所在部分，默认为真\n
-    starter与ender若为None则默认从首或尾开始"""
-    try:
-        if starter is None:
-            includeStart = True
-            starter = Data[0]
-        if ender is None:
-            includend = True
-            ender = Data[len(Data) - 1]
-        if includend:
-            if includeStart:
-                return Data[Data.index(starter):Data.index(ender) + 1]
-            else:
-                return Data[Data.index(starter) + 1:Data.index(ender) + 1]
-        else:
-            if includeStart:
-                return Data[Data.index(starter):Data.index(ender)]
-            else:
-                return Data[Data.index(starter) + 1:Data.index(ender)]
-    except:
-        return 0
-
-
-def lenFunction(fun) -> int:
-    """取得函数指令部分长度，即忽略#开头的注释"""
-    try:
-        f = 0
-        for i in fun:
-            if i.replace(" ", '')[0] == '#':
-                f += 1
-        return len(fun) - f
-    except:
-        return -1
-
-
-def funSplit(bigFile, maxCmdLen: int = 10000):
-    """分割bigFile大的函数文件，bigFile需要读入文件流\n
-    返回的部分，每行指令皆带有行尾换行符\\n\n
-    返回-1为大小低于maxCmdLen最长函数指令长度"""
-    bigFile = bigFile.readlines()
-    if lenFunction(bigFile) < maxCmdLen:
-        return -1
-    part = []
-    parts = []
-    h = 0
-    for i in bigFile:
-        if i.replace(" ", '')[0] == '#':
-            part.append(i + '\n')
-        else:
-            part.append(i + '\n')
-            h += 1
-        if h >= 10000:
-            parts.append(part)
-            part = []
-            h = 0
-    return parts
-
-
-# 注意！播放器应该为个人独立播放器，此处bug需要修改
-def makeFuncFiles(musicset, path='./'):
-    """在指定目录下生成函数文件"""
-    from nmcsup.trans import Note2Cmd
-    commands = []
-    starts = []
-    log("=========================正在在此处生成文件:" + path)
-    maxlen = -1
-    for i in range(len(musicset['musics'])):
-        log('写入第' + str(i) + '个数据')
-        commands.append("scoreboard players add @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\"] " +
-                        musicset['musics'][i]['set']['ScoreboardName'] + " 1\n")
-        commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                        musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset'][
-                            'PlayerSelect'] + " title " + musicset['mainset']['MusicTitle'] + "\n")
-        commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                        musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset'][
-                            'PlayerSelect'] + " subtitle 本函数乐曲由§b§l凌云§r§3函数音乐创建§r生成\n")
-        if len(musicset['musics'][i]['notes']) > maxlen:
-            maxlen = len(musicset['musics'][i]['notes'])
-        starts.append("scoreboard objectives add " + musicset['musics'][i]['set']['ScoreboardName'] + " dummy\n")
-        starts.append("summon armor_stand " + musicset['musics'][i]['set']['EntityName'] + '\n')
-        with open(path + musicset['mainset']['MusicTitle'] + '_Part' + str(i) + '.mcfunction', 'w',
-                  encoding='UTF-8') as f:
-            f.writelines(Note2Cmd(musicset['musics'][i]['notes'], musicset['musics'][i]['set']['ScoreboardName'],
-                                  musicset['musics'][i]['set']['Instrument'], musicset['mainset']['PlayerSelect'],
-                                  True))
-    if musicset['mainset']['IsRepeat']:
-        log("增加重复语句")
-        for i in range(len(musicset['musics'])):
-            commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                            musicset['musics'][i]['set']['ScoreboardName'] + "=" + str(
-                (maxlen + 2) * 10) + "}] ~~~ scoreboard players set @e[name=\"" + musicset['musics'][i]['set'][
-                                'EntityName'] + "\"] " + musicset['musics'][i]['set']['ScoreboardName'] + " -1\n")
-    log("增加版权语句")
-    commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    starts.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    log("写入支持文件")
-    with open(path + musicset['mainset']['MusicTitle'] + '_Support.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(commands)
-    log("写入开始文件")
-    with open(path + 'Start_' + musicset['mainset']['MusicTitle'] + '.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(starts)
-    del commands, starts, maxlen
-    log("完成============================")
-
-
-def makeFunDir(musicset, path='./'):
-    """在指定目录下生成函数包文件夹"""
-    import os
-    import uuid
-    log("=============================生成函数包文件夹")
-    # note,packname="Ryoun",FileName="Music",EntityName_='music_support',ScoreboardName_='music_support',
-    # MusicTitle_='Noname',PlayerSelect_='',Repeat_=False,Instrument_='harp'
-    try:
-        os.makedirs(path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-        log("已创建目录" + path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-    except FileExistsError:
-        log("目录已有无需创建")
-        pass
-    # 判断文件皆存在
-    if not (os.path.exists(
-            path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json") and os.path.exists(
-        path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/manifest.json")):
-        log("创建manifest.json以及world_behavior_packs.json")
-        behaviorUuid = uuid.uuid4()
-        with open(path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json", "w") as f:
-            f.write("[\n  {\"pack_id\": \"" + str(behaviorUuid) + "\",\n  \"version\": [ 0, 0, 1 ]}\n]")
-        p = path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset']['PackName'] + \
-            "/manifest.json"
-        with open(p, "w") as f:
-            f.write("{\n  \"format_version\": 1,\n  \"header\": {\n    \"description\": \"" + musicset['mainset'][
-                'PackName'] + " Pack : behavior pack\",\n    \"version\": [ 0, 0, 1 ],\n    \"name\": \"" +
-                    musicset['mainset']['PackName'] + "Pack\",\n    \"uuid\": \"" + str(
-                behaviorUuid) + "\"\n  },\n  \"modules\": [\n    {\n      \"description\": \"" + musicset['mainset'][
-                        'PackName'] + " Pack : behavior pack\",\n      \"type\": \"data\",\n      \"version\":"
-                                      " [ 0, 0, 1 ],\n      \"uuid\": \"" + str(
-                uuid.uuid4()) + "\"\n    }\n  ]\n}")
-    makeFuncFiles(musicset, path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-        'PackName'] + "/functions/")
-    log("完成============================")
-
-
-def makeNewFuncFiles(musicset, path='./'):
-    """在指定目录下生成函数文件"""
-    from msctspt.transfer import newList_conversion_SinglePlayer
-    commands = []
-    starts = []
-    starts.__len__()
-    starts.append("scoreboard objectives add " + musicset['musics'][0]['set']['ScoreboardName'] + " dummy\n")
-    starts.append("summon armor_stand " + musicset['musics'][0]['set']['EntityName'] + '\n')
-    starts.append("scoreboard objectives setdisplay sidebar " + musicset['musics'][0]['set']['ScoreboardName'] + '\n')
-    starts.append("scoreboard players set @e[type=armor_stand, name=\"" + musicset['musics'][0]['set']['EntityName'] +
-                  "\"] " + musicset['musics'][0]['set']['ScoreboardName'] + " 0" + '\n')
-    log("=========================正在在此处生成文件:" + path)
-    commands.append("scoreboard players add @e[name=\"" + musicset['musics'][0]['set']['EntityName'] + "\"] " +
-                    musicset['musics'][0]['set']['ScoreboardName'] + " 1\n")
-    maxlen = -1
-    for i in range(len(musicset['musics'])):
-        log('写入第' + str(i) + '个数据')
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " title " + musicset['mainset']['MusicTitle'] + "\n")
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " subtitle 本函数乐曲由§b§l凌云§r§3函数音乐创建§r生成\n")
-        if len(musicset['musics'][i]['notes']) > maxlen:
-            maxlen = len(musicset['musics'][i]['notes'])
-        with open(path + musicset['mainset']['MusicTitle'] + '_Part' + str(i) + '.mcfunction', 'w',
-                  encoding='UTF-8') as f:
-            f.writelines(newList_conversion_SinglePlayer(musicset['musics'][i]['notes'],
-                                                         musicset['musics'][i]['set']['ScoreboardName']))
-    if musicset['mainset']['IsRepeat']:
-        log("增加重复语句")
-        for i in range(len(musicset['musics'])):
-            commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                            musicset['musics'][i]['set']['ScoreboardName'] + "=" + str(
-                (maxlen + 2) * 10) + "}] ~~~ scoreboard players set @e[name=\"" + musicset['musics'][i]['set'][
-                                'EntityName'] + "\"] " + musicset['musics'][i]['set']['ScoreboardName'] + " -1\n")
-    log("增加版权语句")
-    commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    starts.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    log("写入支持文件")
-    with open(path + musicset['mainset']['MusicTitle'] + '_Support.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(commands)
-    log("写入开始文件")
-    with open(path + 'Start_' + musicset['mainset']['MusicTitle'] + '.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(starts)
-    del commands, starts, maxlen
-    log("完成============================")
-
-
-def makeNewFunDir(musicset, path='./'):
-    """在指定目录下生成函数包文件夹"""
-    import os
-    import uuid
-    log("=============================生成函数包文件夹")
-    # note,packname="Ryoun",FileName="Music",EntityName_='music_support',ScoreboardName_='music_support',
-    # MusicTitle_='Noname',PlayerSelect_='',Repeat_=False,Instrument_='harp'
-    try:
-        os.makedirs(path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-        log("已创建目录" + path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-    except FileExistsError:
-        log("目录已有无需创建")
-        pass
-    # 判断文件皆存在
-    if not (os.path.exists(
-            path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json") and os.path.exists(
-        path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/manifest.json")):
-        log("创建manifest.json以及world_behavior_packs.json")
-        behaviorUuid = uuid.uuid4()
-        with open(path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json", "w") as f:
-            f.write("[\n  {\"pack_id\": \"" + str(behaviorUuid) + "\",\n  \"version\": [ 0, 0, 1 ]}\n]")
-        p = path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset']['PackName'] + \
-            "/manifest.json"
-        with open(p, "w") as f:
-            f.write("{\n  \"format_version\": 1,\n  \"header\": {\n    \"description\": \"" + musicset['mainset'][
-                'PackName'] + " Pack : behavior pack\",\n    \"version\": [ 0, 0, 1 ],\n    \"name\": \"" +
-                    musicset['mainset']['PackName'] + "Pack\",\n    \"uuid\": \"" + str(
-                behaviorUuid) + "\"\n  },\n  \"modules\": [\n    {\n      \"description\": \"" + musicset['mainset'][
-                        'PackName'] + " Pack : behavior pack\",\n      \"type\": \"data\",\n      \"version\":"
-                                      " [ 0, 0, 1 ],\n      \"uuid\": \"" + str(
-                uuid.uuid4()) + "\"\n    }\n  ]\n}")
-    makeNewFuncFiles(musicset, path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-        'PackName'] + "/functions/")
-    log("完成============================")
-
-
-def makeClassFuncFiles(musicset, path='./'):
-    """在指定目录下生成函数文件"""
-    from msctspt.transfer import classList_conversion_SinglePlayer
-    commands = []
-    starts = []
-    starts.__len__()
-    starts.append("scoreboard objectives add " + musicset['musics'][0]['set']['ScoreboardName'] + " dummy\n")
-    starts.append("summon armor_stand " + musicset['musics'][0]['set']['EntityName'] + '\n')
-    starts.append("scoreboard objectives setdisplay sidebar " + musicset['musics'][0]['set']['ScoreboardName'] + '\n')
-    starts.append("scoreboard players set @e[type=armor_stand, name=\"" + musicset['musics'][0]['set']['EntityName'] +
-                  "\"] " + musicset['musics'][0]['set']['ScoreboardName'] + " 0" + '\n')
-    log("=========================正在在此处生成文件:" + path)
-    commands.append("scoreboard players add @e[name=\"" + musicset['musics'][0]['set']['EntityName'] + "\"] " +
-                    musicset['musics'][0]['set']['ScoreboardName'] + " 1\n")
-    maxlen = -1
-    for i in range(len(musicset['musics'])):
-        log('写入第' + str(i) + '个数据')
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " title " + musicset['mainset']['MusicTitle'] + "\n")
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " subtitle 本函数乐曲由§b§l凌云§r§3函数音乐创建§r生成\n")
-        if len(musicset['musics'][i]['notes']) > maxlen:
-            maxlen = len(musicset['musics'][i]['notes'])
-        with open(path + musicset['mainset']['MusicTitle'] + '_Part' + str(i) + '.mcfunction', 'w',
-                  encoding='UTF-8') as f:
-            f.writelines(classList_conversion_SinglePlayer(musicset['musics'][i]['notes'],
-                                                           musicset['musics'][i]['set']['ScoreboardName'],
-                                                           musicset['musics'][i]['set']['Instrument'],
-                                                           musicset['mainset']['PlayerSelect'],
-                                                           True))
-    if musicset['mainset']['IsRepeat']:
-        log("增加重复语句")
-        for i in range(len(musicset['musics'])):
-            commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                            musicset['musics'][i]['set']['ScoreboardName'] + "=" + str(
-                (maxlen + 2) * 10) + "}] ~~~ scoreboard players set @e[name=\"" + musicset['musics'][i]['set'][
-                                'EntityName'] + "\"] " + musicset['musics'][i]['set']['ScoreboardName'] + " -1\n")
-    log("增加版权语句")
-    commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    starts.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    log("写入支持文件")
-    with open(path + musicset['mainset']['MusicTitle'] + '_Support.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(commands)
-    log("写入开始文件")
-    with open(path + 'Start_' + musicset['mainset']['MusicTitle'] + '.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(starts)
-    del commands, starts, maxlen
-    log("完成============================")
-
-
-def makeClassFunDir(musicset, path='./'):
-    """在指定目录下生成函数包文件夹"""
-    import os
-    import uuid
-    log("=============================生成函数包文件夹")
-    # note,packname="Ryoun",FileName="Music",EntityName_='music_support',ScoreboardName_='music_support',
-    # MusicTitle_='Noname',PlayerSelect_='',Repeat_=False,Instrument_='harp'
-    try:
-        os.makedirs(path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-        log("已创建目录" + path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-    except FileExistsError:
-        log("目录已有无需创建")
-        pass
-    # 判断文件皆存在
-    if not (os.path.exists(
-            path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json") and os.path.exists(
-        path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/manifest.json")):
-        log("创建manifest.json以及world_behavior_packs.json")
-        behaviorUuid = uuid.uuid4()
-        with open(path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json", "w") as f:
-            f.write("[\n  {\"pack_id\": \"" + str(behaviorUuid) + "\",\n  \"version\": [ 0, 0, 1 ]}\n]")
-        p = path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset']['PackName'] + \
-            "/manifest.json"
-        with open(p, "w") as f:
-            f.write("{\n  \"format_version\": 1,\n  \"header\": {\n    \"description\": \"" + musicset['mainset'][
-                'PackName'] + " Pack : behavior pack\",\n    \"version\": [ 0, 0, 1 ],\n    \"name\": \"" +
-                    musicset['mainset']['PackName'] + "Pack\",\n    \"uuid\": \"" + str(
-                behaviorUuid) + "\"\n  },\n  \"modules\": [\n    {\n      \"description\": \"" + musicset['mainset'][
-                        'PackName'] + " Pack : behavior pack\",\n      \"type\": \"data\",\n      \"version\":"
-                                      " [ 0, 0, 1 ],\n      \"uuid\": \"" + str(
-                uuid.uuid4()) + "\"\n    }\n  ]\n}")
-    makeClassFuncFiles(musicset, path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-        'PackName'] + "/functions/")
-    log("完成============================")
-
-
-"""
-这里是往事，用于记载一些用不到的功能
-
-#存在于 Musicreater.py 播放(试听)音乐
-def PlayNote(Notes, t=480):  # Notes是音符列表，t是一拍占有的毫秒数
-    tkinter.messagebox.showinfo(title='提示！', message="播放发音不一定标准\n说不定还会坏音响/(ㄒoㄒ)/~~qwq\n请注意。")
-    import winsound
-    import time
-    from nmcsup.trans import mcnote2freq
-    Notes = mcnote2freq(Notes)
-    for frequency, duration in Notes:
-        log("播放："+str([int(frequency), int(duration*t)]))
-        if int(frequency) != 0:
-            winsound.Beep(int(frequency), int(duration*t))
-        elif int(frequency) == 0:
-            time.sleep(duration*t/1000)
-
-#同上，执行播放命令
-def PlayOne():
-    log("试听")
-    tkinter.messagebox.showwarning(title="警告⚠", message="试听音质可能引起您的不适，更可能引起您的扬声器的不适，请酌情播放。")
-    global NowMusic
-    PlayNote(dataset[0]['musics'][NowMusic]['notes'])
-
-
-
-#同上，是早期 MinecraftMusicFunctionMaker.py (函数音创)的代码转移至音·创时的注解
-n2c(dataset[0]['musics'][i]['notes'],EntityName=dataset[0]['musics'][i]['set']['EntityName'],ScoreboardName=dataset[0]['
-musics'][i]['set']['ScoreboardName'],PlayerSelect=dataset[0]['mainset']['PlayerSelect'],Instrument=dataset[0]['musics']
-i]['set']["Instrument"])
-
-
-"""

msctspt/settings.py

@@ -1,18 +0,0 @@
-# -*- coding:utf-8 -*-
-
-
-
-
-settings = {
-    'language' : 'zh-CN',
-    'theme' : {
-        '' : '',
-    },
-}
-
-class msctSetting:
-    def __init__(self,**settings) -> None:
-        pass
-        
-    def __call__(self, **kwds):
-        pass

msctspt/threadOpera.py

@@ -1,27 +0,0 @@
-
-
-
-import threading
-
-
-class NewThread(threading.Thread):
-    '''新建一个进程来运行函数，函数运行完毕后可以使用.getResult方法获取其返回值'''
-    def __init__(self, func, args=()):
-        super(NewThread, self).__init__()
-        self.func = func
-        self.args = args
-    def run(self):
-        self.result = self.func(*self.args)
-    def getResult(self):
-        threading.Thread.join(self)  # 等待线程执行完毕
-        try:
-            return self.result
-        except Exception:
-            return None
-
-#
-# ————————————————
-# 版权声明：上面的类NewThread修改自CSDN博主「星火燎愿」的原创文章中的内容，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
-# 原文链接：https://blog.csdn.net/xpt211314/article/details/109543014
-# ————————————————
-#

msctspt/transfer.py

@@ -1,541 +0,0 @@
-"""音·创 的转换工具库"""
-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：4个--未解决1个；语法（一级）错误：302个
-
-
-# 可序列化对象，即可迭代对象
-from typing import Iterable
-
-import amulet
-
-from amulet.api.block import Block
-from amulet.utils.world_utils import block_coords_to_chunk_coords as bc2cc
-from amulet_nbt import TAG_String as ts
-from nmcsup.log import log
-
-
-def hans2pinyin(hans, style=3):
-    """将汉字字符串转化为拼音字符串"""
-    from pypinyin import lazy_pinyin
-    result = lazy_pinyin(hans=hans, style=style)
-    final = ''
-    for i in result:
-        final += i
-    return final
-
-
-def classList_conversion_SinglePlayer(List: list, ScoreboardName: str, Instrument: str, playerSelection: str = '',
-                                      isProsess: bool = False) -> list:
-    from bgArrayLib.compute import round_up
-    from bgArrayLib.pitchStrConstant import pitch
-    commands = []
-    length = len(List)
-    j = 1
-    print(List)
-    for k in range(len(List)):
-        i = List[k][0]
-        print(i)
-        print(type(i))
-        try:
-            if i.instrument > 119:
-                pass
-            else:
-                commands.append(
-                    f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                    f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~{127 - i.velocity} "
-                    f"~ playsound {Instrument} @s ~ ~ ~ 1000 {pitch.get(str(i.pitch))} 1000\n")
-                if isProsess:
-                    commands.append(
-                        f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                        f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~ ~ "
-                        f"title @s actionbar §e▶  播放中：  §a{j}/{length}  ||  {int(j / length * 1000) / 10}\n")
-                    j += 1
-        except:
-            pass
-            # a += List[i][1]
-    # commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    print(commands)
-    return commands
-
-
-def newList_conversion_SinglePlayer(List: list, ScoreboardName: str, playerSelection: str = '',
-                                    isProsess: bool = False) -> list:
-    from bgArrayLib.compute import round_up
-    commands = []
-    length = len(List)
-    j = 1
-    print(List)
-    for k in range(len(List)):
-        i = List[k][0]
-        print(i)
-        print(type(i))
-        try:
-            if i.instrument > 119:
-                pass
-            else:
-                commands.append(
-                    f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                    f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~{127 - i.velocity} "
-                    f"~ playsound {i.instrument}{i.CD}.{i.pitch} @s ~ ~ ~ 1000 1.0 1000\n")
-                if isProsess:
-                    commands.append(
-                        f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                        f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~ ~ "
-                        f"title @s actionbar §e▶  播放中：  §a{j}/{length}  ||  {int(j / length * 1000) / 10}\n")
-                    j += 1
-        except:
-            pass
-            # a += List[i][1]
-    # commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    print(commands)
-    return commands
-
-
-def classList_conversion(List: list, ScoreboardName: str, isProsess: bool = False) -> list:
-    from bgArrayLib.compute import round_up
-    commands = []
-    length = len(List)
-    j = 1
-    print(List)
-    for k in range(len(List)):
-        i = List[k][0]
-        print(i)
-        print(type(i))
-        try:
-            if i.instrument > 119:
-                pass
-            else:
-                commands.append("execute @e[scores={" +
-                                ScoreboardName + "=" + str(round_up(i.time_position)).replace(".0", "") + "}] ~ ~" +
-                                str(127 - i.velocity) +
-                                " ~ playsound " +
-                                str(i.instrument) +
-                                str(i.CD) + "." +
-                                str(i.pitch)
-                                + " @a ~ ~ ~ 1000 1.0 1000\n")
-                if isProsess:
-                    commands.append("execute @a"" ~ ~ ~ execute @s[scores={" + ScoreboardName + "=" +
-                                    str(round_up(i.time_position)).replace(".0", "") +
-                                    "}] ~ ~ ~ title @s actionbar §e▶  播放中：  §a" +
-                                    str(j) + "/" + str(length) + "  ||  " + str(int(j / length * 1000) / 10) + "\n")
-                    j += 1
-        except AttributeError:
-            pass
-            # a += List[i][1]
-    # commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    print(commands)
-    return commands
-
-
-def formCmdBlock(direction: Iterable, command: str, particularValue: int, impluse: int = 0, condition: bool = False,
-                 needRedstone: bool = True, tickDelay: int = 0, customName: str = '', lastOutput: str = '',
-                 executeOnFirstTick: bool = False, trackOutput: bool = True):
-    """
-    使用指定项目返回指定的指令方块格式字典
-    :param direction: `list[x: int, y: int, z: int]`
-        方块位置
-    :param command: `str`
-        指令
-    :param particularValue:
-        方块特殊值，即朝向
-            :0	下	无条件
-            :1	上	无条件
-            :2	z轴负方向	无条件
-            :3	z轴正方向	无条件
-            :4	x轴负方向	无条件
-            :5	x轴正方向	无条件
-            :6	下	无条件
-            :7	下	无条件
-
-            :8	下	有条件
-            :9	上	有条件
-            :10	z轴负方向	有条件
-            :11	z轴正方向	有条件
-            :12	x轴负方向	有条件
-            :13	x轴正方向	有条件
-            :14	下	有条件
-            :14	下	有条件
-        注意！此处特殊值中的条件会被下面condition参数覆写
-    :param impluse: `int 0|1|2`
-        方块类型
-            0脉冲 1循环 2连锁
-    :param condition: `bool`
-        是否有条件
-    :param needRedstone: `bool`
-        是否需要红石
-    :param tickDelay: `int`
-        执行延时
-    :param customName: `str`
-        悬浮字
-    :param lastOutput: `str`
-        上次输出字符串，注意此处需要留空
-    :param executeOnFirstTick: `bool`
-        执行第一个已选项(循环指令方块是否激活后立即执行，若为False，则从激活时起延迟后第一次执行)
-    :param trackOutput: `bool`
-        是否输出
-
-    :return: 指令方块字典结构，如下
-    """
-    '''
-    :param block: {
-        "direction": [x: int, y: int, z: int]  #方块位置
-        "block_name": str,  #方块名称（无需指定，默认为command_block）
-        "particular_value": int,  #方块特殊值
-        "impluse": int,  #方块类型0脉冲 1循环 2连锁 unsigned_int32
-        "command": str,  #指令
-        "customName": str,  #悬浮字
-        "lastOutput": str,  #上次输出
-        "tickdelay": int,  #方块延时 int32
-        "executeOnFirstTick": int,  #执行第一个选项 1 bytes
-        "trackOutput": int,  #是否输出 1 bytes
-        "conditional": int,  #是否有条件 1 bytes
-        "needRedstone": int  #是否需要红石 1 bytes
-    }
-    '''
-    return {"direction": direction,
-            "block_name": "command_block",
-            "particular_value": particularValue,
-            "impluse": impluse,
-            "command": command,
-            "customName": customName,
-            "lastOutput": lastOutput,
-            "tickdelay": tickDelay,
-            "executeOnFirstTick": executeOnFirstTick,
-            "trackOutput": trackOutput,
-            "conditional": condition,
-            "needRedstone": needRedstone
-            }
-
-
-def note2bdx(filePath: str, dire: list, Notes: list, ScoreboardName: str, Instrument: str,
-             PlayerSelect: str = '', isProsess: bool = False, height: int = 200):
-    """使用方法同Note2Cmd
-    :param 参数说明：
-        filePath: 生成.bdx文件的位置
-        dire: 指令方块在地图中生成的起始位置（相对位置）
-        Notes: 以 list[ list[ float我的世界playsound指令音调 , float延续时常（单位s） ] ] 格式存储的音符列表
-                例如Musicreater.py的(dataset[0]['musics'][NowMusic]['notes'])
-        ScoreboardName: 用于执行的计分板名称
-        Instrument: 播放的乐器
-        PlayerSelect: 执行的玩家选择器
-        isProsess: 是否显示进度条（会很卡）
-        height: 生成结构的最高高度
-    :return 返回一个BdxConverter类，同时在指定位置生成.bdx文件"""
-
-    # from msctspt.transfer import formCmdBlock
-    from nmcsup.trans import Note2Cmd
-    from msctspt.bdxOpera_CP import BdxConverter
-    cmd = Note2Cmd(Notes, ScoreboardName, Instrument, PlayerSelect, isProsess)
-    cdl = []
-    # 此处是处理一下，防止有注释
-    for i in cmd:
-        # e = True
-        try:
-            if (i[:i.index('#')].replace(' ', '') != '\n') and (i[:i.index('#')].replace(' ', '') != ''):
-                cdl.append(i[:i.index('#')])
-            # e = False
-        except:  # ValueError
-            cdl.append(i)
-        # finally:
-        #     if e is True:
-        #         cdl.append(i)
-    i = 0
-    down = False
-    blocks = [formCmdBlock(dire, cdl.pop(0), 1, 1)]
-    dire[1] += 1
-    for j in cdl:
-        if dire[1] + i > height:
-            dire[0] += 1
-            i = 0
-            down = not down
-        if dire[1] + i == height:
-            blocks.append(formCmdBlock([dire[0], dire[1] + i, dire[2]], j, 5, 2, False, False))
-        else:
-            if down:
-                blocks.append(formCmdBlock([dire[0], dire[1] + i, dire[2]], j, 0, 2, False, False))
-            else:
-                blocks.append(formCmdBlock([dire[0], dire[1] + i, dire[2]], j, 1, 2, False, False))
-        i += 1
-    del i, cdl, down, cmd
-    return BdxConverter(filePath, 'Build by RyounMusicreater', blocks)
-
-
-def music2BDX(filePath: str, direction: Iterable, music: dict, isProsess: bool = False, height: int = 200,
-              isSquare: bool = False):
-    """使用方法同Note2Cmd
-    :param 参数说明：
-        filePath: 生成.bdx文件的位置
-        dire: 指令方块在地图中生成的起始位置（相对位置）
-        music: 详见 Musicreater.py - dataset[0]
-        isProsess: 是否显示进度条（会很卡）
-        height: 生成结构的最高高度
-        isSquare: 生成的结构是否需要遵循生成正方形原则
-    :return 返回一个BdxConverter类，同时在指定位置生成.bdx文件"""
-    from msctspt.bdxOpera_CP import BdxConverter
-
-    blocks = []
-    '''需要放置的方块'''
-    baseDire = direction
-
-    direction = list(direction)
-
-    for track in music['musics']:
-        cmdList = classList_conversion_SinglePlayer(track['notes'], track['set']['ScoreboardName'],
-                                                    music['mainset']['PlayerSelect'], isProsess)
-        if len(cmdList) == 0:
-            continue
-        elif cmdList is []:
-            continue
-        dire = direction
-        down = False
-        '''当前是否为向下的阶段？'''
-        # 开头的指令方块
-        blocks.append(formCmdBlock(dire,
-                                   f"scoreboard players add @a{music['mainset']['PlayerSelect']} "
-                                   f"{track['set']['ScoreboardName']} 1",
-                                   1, 1))
-        dire[1] += 1
-        blocks.append(formCmdBlock(dire, cmdList.pop(0), 2, needRedstone=False))
-        dire[1] += 1
-        # :0	下	无条件
-        # :1	上	无条件
-        # :2	z轴负方向	无条件
-        # :3	z轴正方向	无条件
-        # :4	x轴负方向	无条件
-        # :5	x轴正方向	无条件
-        for cmd in cmdList:
-            blocks.append(formCmdBlock(dire, cmd, 5 if (down is False and dire[1] == height + direction[1]) or (
-                    down and dire[1] == direction + 1) else 0 if down else 1, 2, needRedstone=False))
-
-            if down:
-                if dire[1] > direction[1] + 1:
-                    dire[1] -= 1
-            else:
-                if dire[1] < height + direction[1]:
-                    dire[1] += 1
-
-            if (down is False and dire[1] == height + direction[1]) or (down and dire[1] == direction + 1):
-                down = not down
-                dire[0] += 1
-        direction[2] += 2
-
-    return BdxConverter(filePath, 'Build by Ryoun Musicreater', blocks)
-
-
-def note2webs(Notes: list, Instrument: str, speed: float = 5.0, PlayerSelect: str = '', isProsess: bool = False):
-    """传入音符，在oaclhost:8080上建立websocket服务器以供我的世界connect/wssever指令连接
-    :param 参数说明：
-        Notes: 以 list[ list[ float我的世界playsound指令音调 , float延续时常（单位s） ] ] 格式存储的音符列表
-        例如Musicreater.py的(dataset[0]['musics'][NowMusic]['notes'])
-        Instrument: 播放的乐器
-        speed: 用于控制播放速度，数值越大，播放速度越快，相当于把一秒变为几拍
-        PlayerSelect: 执行的玩家选择器
-        isProsess: 是否显示进度条
-    :return None"""
-
-    import time
-    import fcwslib
-    # import asyncio
-    from nmcsup.log import log
-    from nmcsup.vers import VER
-
-    async def run_server(websocket):  # , path
-        log('服务器连接创建')
-        await fcwslib.tellraw(websocket, '已连接服务器——音·创' + VER[1] + VER[0] + ' 作者：金羿(W-YI)')
-        length = len(Notes)
-        j = 1
-        for i in range(len(Notes)):
-            await fcwslib.send_command(websocket,
-                                       f'execute @a{PlayerSelect} ~ ~ ~ playsound {Instrument} @s ~ ~ ~ 1000 '
-                                       f'{Notes[i][0]} 1000')
-            if isProsess:
-                await fcwslib.send_command(websocket,
-                                           'execute @a' + PlayerSelect + ' ~ ~ ~ title @s actionbar §e▶  播放中：  §a' +
-                                           str(
-                                               j) + '/' + str(length) + '  ||  ' + str(int(j / length * 1000) / 10))
-                j += 1
-            time.sleep(Notes[i][1] / speed)
-
-    fcwslib.run_server(run_server)
-
-
-def note2RSworld(world: str, startpos: list, notes: list, instrument: str, speed: float = 2.5,
-                 posadder: Iterable = (1, 0, 0), baseblock: str = 'stone'):  # -> bool
-    """传入音符，生成以音符盒存储的红石音乐
-    :param 参数说明：
-        world: 地图文件的路径
-        startpos: list[int,int,int] 开始生成的坐标
-        notes: list[list[float,float]] 以 list[ list[ float我的世界playsound指令音调 , float延续时常（单位s） ] ]
-        格式存储的音符列表 例如Musicreater.py的dataset[0]['musics'][NowMusic]['notes']
-        instrument: 播放的乐器
-        speed: 一拍占多少个中继器延迟(红石刻/rt)
-        posadder: list[int,int,int] 坐标增加规律，即红石的延长时按照此增加规律增加坐标
-        baseblock: 在中继器下垫着啥方块呢~
-    :return 是否生成成功
-    """
-
-    from msctspt.values import height2note, instuments
-
-    def formNoteBlock(note: int, instrument1: str = 'note.harp', powered: bool = False):
-        """生成音符盒方块
-        :param powered:
-        :param instrument1:
-        :param note: 0~24
-        :return Block()"""
-        if powered:
-            powered = 'true'
-        else:
-            powered = 'false'
-        return Block('universal_minecraft', 'notebooks',
-                     {"instrument": ts(instrument1.replace("note.", '')), 'note': ts(str(note)),
-                      'powered': ts(powered)})
-
-    def formRepeater(delay: int, facing: str, locked: bool = False, powered: bool = False):
-        """生成中继器方块
-        :param powered:
-        :param locked:
-        :param facing:
-        :param delay: 1~4
-        :return Block()"""
-        if powered:
-            powered = 'true'
-        else:
-            powered = 'false'
-        if locked:
-            locked = 'true'
-        else:
-            locked = 'false'
-        return Block('universal_minecraft', 'repeater',
-                     {"delay": ts(str(delay)), 'facing': ts(facing), 'locked': ts(locked), 'powered': ts(powered)})
-
-    level = amulet.load_level(world)
-
-    def setblock(block: Block, pos: list):
-        """pos : list[int,int,int]"""
-        cx, cz = bc2cc(pos[0], pos[2])
-        chunk = level.get_chunk(cx, cz, "minecraft:overworld")
-        offset_x, offset_z = pos[0] - 16 * cx, pos[2] - 16 * cz
-        chunk.blocks[offset_x, pos[1], offset_z] = level.block_palette.get_add_block(block)
-        chunk.changed = True
-
-    # 1拍 x 2.5 rt
-    def placeNoteBlock():
-        for i in notes:
-            error = True
-            try:
-                setblock(formNoteBlock(height2note[i[0]], instrument), [startpos[0], startpos[1] + 1, startpos[2]])
-                setblock(Block("universal_minecraft", instuments[i[0]][1]), startpos)
-                error = False
-            except ValueError:
-                log("无法放置音符：" + str(i) + '于' + str(startpos))
-                setblock(Block("universal_minecraft", baseblock), startpos)
-                setblock(Block("universal_minecraft", baseblock), [startpos[0], startpos[1] + 1, startpos[2]])
-            finally:
-                if error is True:
-                    log("无法放置音符：" + str(i) + '于' + str(startpos))
-                    setblock(Block("universal_minecraft", baseblock), startpos)
-                    setblock(Block("universal_minecraft", baseblock), [startpos[0], startpos[1] + 1, startpos[2]])
-            delay = int(i[1] * speed + 0.5)
-            if delay <= 4:
-                startpos[0] += 1
-                setblock(formRepeater(delay, 'west'), [startpos[0], startpos[1] + 1, startpos[2]])
-                setblock(Block("universal_minecraft", baseblock), startpos)
-            else:
-                for j in range(int(delay / 4)):
-                    startpos[0] += 1
-                    setblock(formRepeater(4, 'west'), [startpos[0], startpos[1] + 1, startpos[2]])
-                    setblock(Block("universal_minecraft", baseblock), startpos)
-                if delay % 4 != 0:
-                    startpos[0] += 1
-                    setblock(formRepeater(delay % 4, 'west'), [startpos[0], startpos[1] + 1, startpos[2]])
-                    setblock(Block("universal_minecraft", baseblock), startpos)
-            startpos[0] += posadder[0]
-            startpos[1] += posadder[1]
-            startpos[2] += posadder[2]
-
-    # e = True
-    try:
-        placeNoteBlock()
-        # e = False
-    except:  # ValueError
-        log("无法放置方块了，可能是因为区块未加载叭")
-    # finally:
-    #     if e:
-    #         log("无法放置方块了，可能是因为区块未加载叭")
-    level.save()
-    level.close()
-
-
-class ryStruct:
-
-    def __init__(self, world: str) -> None:
-
-        self.RyStruct = dict()
-        self._world = world
-        self._level = amulet.load_level(world)
-
-    def reloadLevel(self):
-        # e = True
-        try:
-            self._level = amulet.load_level(self.world)
-            # e = False
-        except:  # ValueError
-            log("无法重载地图")
-        # finally:
-        #     if e:
-        #         log("无法重载地图")
-
-    def closeLevel(self):
-        # e = True
-        try:
-            self._level.close()
-            # e = False
-        except:  # ValueError
-            log("无法关闭地图")
-        # finally:
-        #     if e:
-        #         log("无法重载地图")
-
-    def world2Rys(self, startp: list, endp: list, includeAir: bool = False):
-        """将世界转换为RyStruct字典，注意，此函数运行成功后将关闭地图，若要打开需要运行 reloadLevel
-        :param startp: [x,y,z] 转化的起始坐标
-        :param endp  : [x,y,z] 转换的终止坐标，注意，终止坐标需要大于起始坐标，且最终结果包含终止坐标
-        :param includeAir : bool = False 是否包含空气，即空气是否在生成之时覆盖地图内容
-        :return dict RyStruct """
-
-        level = self._level
-
-        for x in range(startp[0], endp[0] + 1):
-            for y in range(startp[1], endp[1] + 1):
-                for z in range(startp[2], endp[2] + 1):
-
-                    RyStructBlock = dict()
-
-                    cx, cz = bc2cc(x, z)
-                    chunk = level.get_chunk(cx, cz, "minecraft:overworld")
-                    universal_block = chunk.block_palette[chunk.blocks[x - 16 * cx, y, z - 16 * cz]]
-                    if universal_block == Block("universal_minecraft", "air") and includeAir:
-                        continue
-                    universal_block_entity = chunk.block_entities.get((x, y, z), None)
-
-                    RyStructBlock["block"] = str(universal_block)
-                    RyStructBlock["blockEntity"] = str(universal_block_entity)
-
-                    log("载入方块数据" + str(RyStructBlock))
-
-                    self.RyStruct[(x, y, z)] = RyStructBlock
-
-        level.close()
-
-        return self.RyStruct
-
-
-"""
-RyStruct = {
-    (0,0,0) = {
-        "block": str 完整的方块结构
-        "blockEntity": str | 'None'
-    }
-}
-"""

msctspt/values.py

@@ -1,56 +0,0 @@
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：40个
-
-instuments = {
-    'note.banjo': ['班卓琴', 'hay_block'],
-    'note.bass': ['贝斯', 'planks'],
-    'note.bassattack': ['低音鼓/贝斯', 'log'],
-    'note.bd': ['底鼓', 'stone'],  # 即basedrum
-    'note.bell': ['铃铛/钟琴', 'gold_block'],
-    'note.bit': ['比特/“芯片”(方波)', 'emerald_block'],
-    'note.chime': ['管钟', 'packed_ice'],
-    'note.cow_bell': ['牛铃', 'soul_sand'],
-    'note.didgeridoo': ['迪吉里杜管', 'pumpkin'],
-    'note.flute': ['长笛', 'clay'],
-    'note.guitar': ['吉他', 'wool'],
-    'note.harp': ['竖琴/钢琴', 'concrete'],  # 任意其他类型的方块皆可
-    'note.hat': ['击鼓沿/架子鼓', 'glass'],
-    'note.iron_xylophone': ['“铁木琴”(颤音琴)', 'iron_block'],
-    'note.pling': ['“扣弦”(电钢琴)', 'glowstone'],
-    'note.snare': ['小军鼓', 'sand'],
-    'note.xylophone': ['木琴', 'bone_block']
-}
-'''乐器对照表\n
-乐器英文:[中文, 对应音符盒下方块名称]
-注：方块仅取一个'''
-
-height2note = {
-    0.5: 0,
-    0.53: 1,
-    0.56: 2,
-    0.6: 3,
-    0.63: 4,
-    0.67: 5,
-    0.7: 6,
-    0.75: 7,
-    0.8: 8,
-    0.84: 9,
-    0.9: 10,
-    0.94: 11,
-    1.0: 12,
-
-    1.05: 13,
-    1.12: 14,
-    1.2: 15,
-    1.25: 16,
-    1.33: 17,
-    1.4: 18,
-    1.5: 19,
-    1.6: 20,
-    1.7: 21,
-    1.8: 22,
-    1.9: 23,
-    2.0: 24,
-}
-'''音高对照表\n
-MC音高:音符盒音调'''

nmcsup/NFC Dev Log.txt

@@ -1,72 +0,0 @@
-从此日志开始，我的世界函数音乐构建更名为 函数音创 NoteFunCreater（谐音NotFun[狗头]），版本号更为0.1.0开始
-
-注意，运行此文件需要第三方库：
-1. mido 用于对midi文件的解码
-2. py7zr 用于对7z压缩包的压缩与解压等（需pycparser, cffi, texttable, pyzstd, pyppmd, pycryptodomex, multivolumefile, brotli, bcj-cffi支持）  -(从0.1.3开始不需要)
-3. zipfile 用于自动生成函数包的压缩
-4. pystray 用于支持窗口任务栏
-5. pillow （相当于Python2的PIL）用于绘图
-
-
-	0.1.0
-2021 7 10 - 2021 7 12
-1.程序窗口化
-2.仅支持基本的菜单操作
-3.程序文件皆储存至其相应目录下
-4.程序./bin/目录下文件将会自动防修改
-5.删除了彩蛋
-
-
-	0.1.1
-2021 7 14
-1.新增版本辨别的提示
-2.窗口中显示歌曲信息
-
-
-	0.1.2
-2021 7 14 - 2021 7 15
-1.在没运行过的机器上会自动安装库
-2.从midi导入时不会删除其他音轨
-3.改进UI样式
-4.支持对于单个音轨设置的修改以及音乐主设置的修改
-5.当未保存便退出时，会询问存储
-6.新增加载进度提示
-
-
-	0.1.3
-2021 7 15 - 2021 7 19
-1.不再从文件中读取音符及乐器信息（所以包更小了）
-2.改进UI
-3.修复了修改玩家选择器时变更了音乐标题的bug
-4.新增删除当前选定音轨按钮
-5.新增重置设置按钮（将音乐总设置设置为开始时的设置）
-6.运用多线程加载函数与文件等，程序运行效率更高
-7.修复变量作用域混淆问题
-
-
-	0.1.3.1
-2021 7 19
-1.修复了菜单中无法退出程序的问题
-
-
-	0.1.4
-2021 7 22
-1.支持显示指令于列表中
-
-
-
-
-
-
-	TO-DO
-1.支持从midi文件的元信息中收取音符信息并自动生成
-2.支持生成zip函数包
-3.支持使用WebSocket接口自动播放已编辑的音乐
-4.可以编辑多个项目
-5.能够自动将一个长串的音乐分成多个函数文件
-6.支持用户导入自己的乐器
-7.支持汇报崩溃记录（通过邮件附件的方式）
-8.支持播放字幕
-9.支持任务栏角标与通知
-10.将控制台版本的彩蛋移植到此版本，开启了任务栏
-11.可编辑音符

nmcsup/NMC Dev Log.txt

@@ -1,36 +0,0 @@
-世界音创(NoteMapCreater)是金羿开发的一款用于生成我的世界中各类有关音乐的物件的软件
-软件禁止商用，源代码始终公开，如使用未经授权的音乐经过此软件生成的任何物件侵犯了他人权利与本软件及其作者无关
-
-Copyright © W-YI 2021
-
-开头，特别感谢：
-KCINE：提供Cinemusicedit函数包(虽然函数包没怎么用过)
-Charlie_Ping：提供MusiCreaterBot(音乐地图生成QQ机器人)源码核心以及时不时的催更(虽然源码没有抄)
-金羿(作者本人)：提供NoteFunCreater(函数音创)的制作经验以及时不时的摸鱼(虽然不是很支持函数音创)
-广大群友：高效的催更作业让我以蜗牛的速度前进
-
-	Alpha 0.0.0
-2021 8 1 - 2021 8 10
-1.确定了大概的功能
-2.不支持无参数传入
-3.可以查看帮助，但是帮助大多功能没实现
-4.可以从格式文本、midi文件、钢琴声音MP3导入音轨
-5.可以生成一些方块到世界里，但是没有播放器(半支持bw开关)
-5.提供了修改文件地址的方法，但是不能修改
-
-	Alpha 0.0.1
-2021 8 10
-1.可以从函数音创的工程文件读取音轨
-2.可以新建一个空白世界来生成
-3.支持修改输出文件地址
-4.支持修改输出方块起始位置
-5.支持指定播放乐器，执行实体，执行积分板，播放玩家选择器
-6.可以生成指令音乐地图(完全支持-w开关)
-
-	Beta 0.0.0
-2021 8 X?
-1.除了-nw 和 -f 开关不支持以外都支持了
-
-	Beta 0.0.1
-2021 8 19
-1.修复了大量bug

nmcsup/const.py

@@ -1,312 +0,0 @@
-"""音创系列的音符对照表 以及一系列常数"""
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：109个
-
-
-notes = {
-    '....A': [0.074, 27.5, 'wood', 8],
-    '....A#': [0.0787, 29.135, 'wood', 9],
-    '....B': [0.083, 30.868, 'wood', 10],
-    '...C': [0.088, 32.703, 'wood', 11],
-    '...C#': [0.094, 34.648, 'wood', 12],
-    '...D': [0.1, 36.708, 'wood', 13],
-    '...D#': [0.105, 38.891, 'log', 0],
-    '...E': [0.11, 41.203, 'log', 1],
-    '...F': [0.12, 43.654, 'log', 2],
-    '...F#': [0.125, 46.249, 'wood', 0],
-    '...G': [0.13, 48.999, 'wood', 1],
-    '...G#': [0.14, 51.913, 'wood', 2],
-    '...A': [0.15, 55.0, 'wood', 3],
-    '...A#': [0.16, 58.27, 'wood', 4],
-    '...B': [0.17, 61.735, 'wood', 5],
-    '..C': [0.18, 65.406, 'wool', 0],
-    '..C#': [0.19, 69.296, 'wool', 1],
-    '..D': [0.2, 73.416, 'wool', 2],
-    '..D#': [0.21, 77.782, 'wool', 3],
-    '..E': [0.22, 82.407, 'wool', 4],
-    '..F': [0.235, 87.307, 'wool', 5],
-    '..F#': [0.25, 92.499, 'concretepowder', 0],
-    '..G': [0.26, 97.999, 'concretepowder', 1],
-    '..G#': [0.28, 103.826, 'concretepowder', 2],
-    '..A': [0.3, 110.0, 'concretepowder', 3],
-    '..A#': [0.31, 116.541, 'concretepowder', 4],
-    '..B': [0.33, 123.471, 'concretepowder', 5],
-    '.C': [0.35, 130.813, 'concretepowder', 6],
-    '.C#': [0.37, 138.591, 'concretepowder', 7],
-    '.D': [0.4, 146.832, 'concretepowder', 8],
-    '.D#': [0.42, 155.563, 'concretepowder', 9],
-    '.E': [0.44, 164.814, 'concretepowder', 10],
-    '.F': [0.47, 174.614, 'concretepowder', 11],
-    '.F#': [0.5, 184.997, 'concretepowder', 12],
-    '.G': [0.53, 195.998, 'concretepowder', 13],
-    '.G#': [0.56, 207.652, 'concretepowder', 14],
-    '.A': [0.6, 220.0, 'concretepowder', 15],
-    '.A#': [0.63, 233.082, 'concrete', 0],
-    '.B': [0.67, 246.942, 'concrete', 1],
-    'C': [0.7, 261.626, 'concrete', 2],
-    'C#': [0.75, 277.183, 'concrete', 3],
-    'D': [0.8, 293.665, 'concrete', 4],
-    'D#': [0.84, 311.127, 'concrete', 5],
-    'E': [0.9, 329.628, 'concrete', 6],
-    'F': [0.94, 349.228, 'concrete', 7],
-    'F#': [1.0, 369.994, 'concrete', 8],
-    'G': [1.05, 391.995, 'concrete', 9],
-    'G#': [1.12, 415.305, 'concrete', 10],
-    'A': [1.2, 440.0, 'concrete', 11],
-    'A#': [1.25, 466.164, 'concrete', 12],
-    'B': [1.33, 493.883, 'concrete', 13],
-    '`C': [1.4, 523.251, 'concrete', 14],
-    '`C#': [1.5, 554.365, 'concrete', 15],
-    '`D': [1.6, 587.33, 'stained_hardened_clay', 0],
-    '`D#': [1.7, 622.254, 'stained_hardened_clay', 1],
-    '`E': [1.8, 659.255, 'stained_hardened_clay', 2],
-    '`F': [1.9, 698.456, 'stained_hardened_clay', 3],
-    '`F#': [2.0, 739.989, 'stained_hardened_clay', 4],
-    '`G': [2.1, 783.991, 'stained_hardened_clay', 5],
-    '`G#': [2.24, 830.609, 'stained_hardened_clay', 6],
-    '`A': [2.4, 880.0, 'stained_hardened_clay', 7],
-    '`A#': [2.5, 932.328, 'stained_hardened_clay', 8],
-    '`B': [2.67, 987.767, 'stained_hardened_clay', 9],
-    '``C': [2.83, 1046.502, 'stained_hardened_clay', 10],
-    '``C#': [3.0, 1108.731, 'stained_hardened_clay', 11],
-    '``D': [3.17, 1174.659, 'stained_hardened_clay', 12],
-    '``D#': [3.36, 1244.508, 'stained_hardened_clay', 13],
-    '``E': [3.56, 1318.51, 'stained_hardened_clay', 14],
-    '``F': [3.78, 1396.913, 'stained_hardened_clay', 15],
-    '``F#': [4.0, 1479.978, 'white_glazed_terracotta', 0],
-    '``G': [4.24, 1567.982, 'orange_glazed_terracotta', 0],
-    '``G#': [4.5, 1661.219, 'magenta_glazed_terracotta', 0],
-    '``A': [4.76, 1760.0, 'light_blue_glazed_terracotta', 0],
-    '``A#': [5.04, 1864.655, 'yellow_glazed_terracotta', 0],
-    '``B': [5.34, 1975.533, 'lime_glazed_terracotta', 0],
-    '```C': [5.66, 2093.005, 'pink_glazed_terracotta', 0],
-    '```C#': [6.0, 2217.461, 'gray_glazed_terracotta', 0],
-    '```D': [6.35, 2349.318, 'silver_glazed_terracotta', 0],
-    '```D#': [6.73, 2489.016, 'cyan_glazed_terracotta', 0],
-    '```E': [7.13, 2637.02, 'purple_glazed_terracotta', 0],
-    '```F': [7.55, 2793.826, 'blue_glazed_terracotta', 0],
-    '```F#': [8.0, 2959.955, 'brown_glazed_terracotta', 0],
-    '```G': [8.47, 3135.963, 'green_glazed_terracotta', 0],
-    '```G#': [8.98, 3322.438, 'red_glazed_terracotta', 0],
-    '```A': [9.51, 3520.0, 'black_glazed_terracotta', 0],
-    '```A#': [10.08, 3729.31, 'stained_glass', 0],
-    '```B': [10.68, 3951.066, 'stained_glass', 1],
-    '````C': [11.31, 4186.009, 'stained_glass', 2],
-    '0': [0.0, 0.0, 'glass', 0]
-}
-'''音符对照表\n
-音符:[MC音调, 声音频率, 方块名称, 数据值]'''
-
-# 方块
-'''
-blocks = {
-    0.074 : ['stained_glass', 3],
-    0.0787 : ['stained_glass', 4],
-    0.083 : ['stained_glass', 5],
-    0.088 : ['stained_glass', 6],
-    0.094 : ['stained_glass', 7],
-    0.1 : ['stained_glass', 8],
-    0.105 : ['stained_glass', 9],
-    0.11 : ['stained_glass', 10],
-    0.12 : ['stained_glass', 11],
-    0.125 : ['stained_glass', 12],
-    0.13 : ['stained_glass', 13],
-    0.14 : ['stained_glass', 14],
-    0.15 : ['stained_glass', 15],
-    0.16 : ['wool', 0],
-    0.17 : ['wool', 1],
-    0.18 : ['wool', 2],
-    0.19 : ['wool', 3],
-    0.2 : ['wool', 4],
-    0.21 : ['wool', 5],
-    0.22 : ['wool', 6],
-    0.235 : ['wool', 7],
-    0.25 : ['concretepowder', 0],
-    0.26 : ['concretepowder', 1],
-    0.28 : ['concretepowder', 2],
-    0.3 : ['concretepowder', 3],
-    0.31 : ['concretepowder', 4],
-    0.33 : ['concretepowder', 5],
-    0.35 : ['concretepowder', 6],
-    0.37 : ['concretepowder', 7],
-    0.4 : ['concretepowder', 8],
-    0.42 : ['concretepowder', 9],
-    0.44 : ['concretepowder', 10],
-    0.47 : ['concretepowder', 11],
-    0.5 : ['concretepowder', 12],
-    0.53 : ['concretepowder', 13],
-    0.56 : ['concretepowder', 14],
-    0.6 : ['concretepowder', 15],
-    0.63 : ['concrete', 0],
-    0.67 : ['concrete', 1],
-    0.7 : ['concrete', 2],
-    0.75 : ['concrete', 3],
-    0.8 : ['concrete', 4],
-    0.84 : ['concrete', 5],
-    0.9 : ['concrete', 6],
-    0.94 : ['concrete', 7],
-    1.0 : ['concrete', 8],
-    1.05 : ['concrete', 9],
-    1.12 : ['concrete', 10],
-    1.2 : ['concrete', 11],
-    1.25 : ['concrete', 12],
-    1.33 : ['concrete', 13],
-    1.4 : ['concrete', 14],
-    1.5 : ['concrete', 15],
-    1.6 : ['stained_hardened_clay', 0],
-    1.7 : ['stained_hardened_clay', 1],
-    1.8 : ['stained_hardened_clay', 2],
-    1.9 : ['stained_hardened_clay', 3],
-    2.0 : ['stained_hardened_clay', 4],
-    2.1 : ['stained_hardened_clay', 5],
-    2.24 : ['stained_hardened_clay', 6],
-    2.4 : ['stained_hardened_clay', 7],
-    2.5 : ['stained_hardened_clay', 8],
-    2.67 : ['stained_hardened_clay', 9],
-    2.83 : ['stained_hardened_clay', 10],
-    3.0 : ['stained_hardened_clay', 11],
-    3.17 : ['stained_hardened_clay', 12],
-    3.36 : ['stained_hardened_clay', 13],
-    3.56 : ['stained_hardened_clay', 14],
-    3.78 : ['stained_hardened_clay', 15],
-    4.0 : ['stained_glass_pane', 0],
-    4.24 : ['stained_glass_pane', 1],
-    4.5 : ['stained_glass_pane', 2],
-    4.76 : ['stained_glass_pane', 3],
-    5.04 : ['stained_glass_pane', 4],
-    5.34 : ['stained_glass_pane', 5],
-    5.66 : ['stained_glass_pane', 6],
-    6.0 : ['stained_glass_pane', 7],
-    6.35 : ['stained_glass_pane', 8],
-    6.73 : ['stained_glass_pane', 9],
-    7.13 : ['stained_glass_pane', 10],
-    7.55 : ['stained_glass_pane', 11],
-    8.0 : ['stained_glass_pane', 12],
-    8.47 : ['stained_glass_pane', 13],
-    8.98 : ['stained_glass_pane', 14],
-    9.51 : ['stained_glass_pane', 15],
-    10.08 : ['stained_glass', 0],
-    10.68 : ['stained_glass', 1],
-    11.31 : ['stained_glass', 2],
-    0.0 : ['glass', 0]
-}
-#向查理平致敬！！！！！
-'''
-
-Blocks = {
-    0.074: 'barrel',
-    0.0787: 'beacon',
-    0.083: 'bedrock',
-    0.088: 'black_glazed_terracotta',
-    0.094: 'blast_furnace',
-    0.1: 'blue_glazed_terracotta',
-    0.105: 'blue_ice',
-    0.11: 'bone_block',
-    0.12: 'bookshelf',
-    0.125: 'brick_block',
-    0.13: 'brown_glazed_terracotta',
-    0.14: 'cartography_table',
-    0.15: 'carved_pumpkin',
-    0.16: 'clay',
-    0.17: 'coal_block',
-    0.18: 'coal_ore',
-    0.19: 'cobblestone',
-    0.2: 'concrete',
-    0.21: 'crafting_table',
-    0.22: 'cyan_glazed_terracotta',
-    0.235: 'diamond_block',
-    0.25: 'diamond_ore',
-    0.26: 'white_glazed_terracotta',
-    0.28: 'dispenser',
-    0.3: 'dried_kelp_block',
-    0.31: 'dropper',
-    0.33: 'emerald_block',
-    0.35: 'emerald_ore',
-    0.37: 'end_bricks',
-    0.4: 'end_stone',
-    0.42: 'fletching_table',
-    0.44: 'furnace',
-    0.47: 'glass',
-    0.5: 'glowingobsidian',
-    0.53: 'glowstone',
-    0.56: 'gold_block',
-    0.6: 'gold_ore',
-    0.63: 'grass',
-    0.67: 'gray_glazed_terracotta',
-    0.7: 'green_glazed_terracotta',
-    0.75: 'hardened_clay',
-    0.8: 'hay_block',
-    0.84: 'iron_block',
-    0.9: 'iron_ore',
-    0.94: 'jukebox',
-    1.0: 'lapis_block',
-    1.05: 'lapis_ore',
-    1.12: 'light_blue_glazed_terracotta',
-    1.2: 'lime_glazed_terracotta',
-    1.25: 'lit_pumpkin',
-    1.33: 'log',
-    1.4: 'loom',
-    1.5: 'magenta_glazed_terracotta',
-    1.6: 'magma',
-    1.7: 'melon_block',
-    1.8: 'web',
-    1.9: 'mossy_cobblestone',
-    2.0: 'nether_brick',
-    2.1: 'nether_wart_block',
-    2.24: 'netherrack',
-    2.4: 'noteblock',
-    2.5: 'observer',
-    2.67: 'obsidian',
-    2.83: 'orange_glazed_terracotta',
-    3.0: 'pink_glazed_terracotta',
-    3.17: 'piston',
-    3.36: 'planks',
-    3.56: 'prismarine',
-    3.78: 'pumpkin',
-    4.0: 'purple_glazed_terracotta',
-    4.24: 'purpur_block',
-    4.5: 'quartz_block',
-    4.76: 'quartz_ore',
-    5.04: 'red_glazed_terracotta',
-    5.34: 'red_nether_brick',
-    5.66: 'red_sandstone',
-    6.0: 'redstone_block',
-    6.35: 'yellow_glazed_terracotta',
-    6.73: 'sandstone',
-    7.13: 'stonebrick',
-    7.55: 'silver_glazed_terracotta',
-    8.0: 'slime',
-    8.47: 'smithing_table',
-    8.98: 'smoker',
-    9.51: 'smooth_stone',
-    10.08: 'snow',
-    10.68: 'soul_sand',
-    11.31: 'sponge',
-    0.0: 'stone'
-}
-'''频率对照表\n
-MC音调:方块名称'''
-
-# 乐器
-Instuments = {
-    'note.banjo': '班卓',
-    'note.bass': '低音',
-    'note.bassattack': '贝斯',
-    'note.bd': '鼓声',
-    'note.bell': '铃声',
-    'note.bit': '比特',
-    'note.cow_bell': '牛铃',
-    'note.didgeridoo': '迪吉',
-    'note.flute': '长笛',
-    'note.guitar': '吉他',
-    'note.harp': '竖琴',
-    'note.hat': '架鼓',
-    'note.chime': '钟声',
-    'note.iron_xylophone': '铁琴',
-    'note.pling': '叮叮',
-    'note.snare': '响弦',
-    'note.xylophone': '木琴'
-}
-'''乐器对照表\n
-乐器英文:中文
-翻译：雪莹工坊Fun-Fer'''

nmcsup/log.py

@@ -1,71 +0,0 @@
-"""提供对于音创系列的日志"""
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：9个
-
-import logging
-import os
-import datetime
-
-StrStartTime = str(datetime.datetime.now()).replace(':', '_')[:-7]
-time = StrStartTime
-
-main_path = './log/'
-
-position = main_path + time
-
-logger = logging.getLogger(__name__)
-logger.setLevel(level=logging.INFO)
-
-if not os.path.exists('./log/'):
-    os.makedirs('./log/')
-
-# try:
-# handler = logging.FileHandler(position + ".logger")
-# except FileNotFoundError:
-# os.makedirs('./log/')
-handler = logging.FileHandler(position + ".logger")
-print(position + ".logger")
-
-handler.setLevel(logging.INFO)
-formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
-handler.setFormatter(formatter)
-
-console = logging.StreamHandler()
-console.setLevel(logging.INFO)
-
-logger.addHandler(handler)
-logger.addHandler(console)
-
-# import logger
-
-# 载入日志功能
-StrStartTime = str(datetime.datetime.now()).replace(':', '_')[:-7]
-# logger.setting(StrStartTime)
-"""字符串型的程序开始时间"""
-
-
-def log(info: str = '', isWrite: bool = True, isPrinted: bool = False, isLoggerLibRecord: bool = True):
-    """
-    info: 信息
-    isPrinted: 是否print（仅限金羿log，python官方的logging照常输出）
-    isLoggerLibRecord: 是否同时在logger库中记录
-    isWrite: 是否write（仅限金羿log，python官方的logging照常输出）
-    """
-    """将信息连同当前时间载入日志"""
-    # 致后来的开发者：请让金羿的log存在吧，不然他自己都看不懂你们写了什么了
-    # 我指的是程序内部
-    # ——金羿
-    if not os.path.exists('./log/'):
-        os.makedirs('./log/')
-    if isWrite:
-        with open('./log/' + StrStartTime + '.msct.log', 'a', encoding='UTF-8') as f:
-            f.write(str(datetime.datetime.now())[11:19] + '	' + info + '\n')
-    if isPrinted:
-        print(str(datetime.datetime.now())[11:19] + '	' + info)
-    if isLoggerLibRecord:
-        logger.info(info)
-
-
-def end():
-    logging.disable(logging.INFO)
-    logging.shutdown()