MWeb
不想阅读全部内容?点击下方的折叠区域查看精简的功能概览。
对于对 MWeb API 感兴趣的开发者,请滚动到页面底部。
MWeb 功能摘要
MWeb 可以通过 GUI 或命令完全控制。
你可以...
- ...在游戏中浏览文件(仅限 GUI)
- ...为服务器上的任意文件或文件夹创建公开链接
- ...为服务器上的任意文件或文件夹创建受限链接(用户、密码、限时、数量限制)
- ...编辑和切换所有已创建的链接
- ...直接将文件夹或压缩包作为资源包发送给玩家
- ...在游戏中压缩和解压文件夹/压缩包
- ...在游戏中删除和重命名文件
- ...定义用于上传文件的文件夹(可像下载一样进行限制)
针对更高级的技术功能,你还可以...
- ...在错误页面上响应自定义 HTML/CSS/JS
- ...定义代理域名(例如使用 mutils.net/<id> 代替 1.2.3.4:1234/<id>)
- ...将每一个单独的操作限制为特定的权限
详细说明与指南分为以下类别:
- 创建下载链接
- 管理文件
- 资源包集成
- 技术信息与设置
若要查看所有权限及更多帮助,请访问 mutils.net/mweb
本项目耗费了大量心血,任何 支持 都将不胜感激!
创建下载链接
创建一个简单的下载链接只需点击一次!
- 打开白名单 GUI(
/ws whitelist 或 /ws -> manage download access)
- 导航至你的文件或文件夹
- 点击显示的按钮以创建链接
你可以直接在导航器中使用快捷键 1 和 2 创建全局链接或个人链接(仅你自己可用)。处理完成后(较大的文件夹需要一些时间进行压缩),系统会为你生成一个新链接。点击“复制”即可将链接复制到剪贴板,分享给任何人或在浏览器中粘贴!
你可以为同一个文件创建多个链接。在文件或文件夹上按下快捷键 4 即可管理所有链接。在这里你可以切换、移除甚至编辑现有链接。
(预览使用的是 mweb.mutils.net 作为代理。这不是默认行为)
管理文件
MWeb 还添加了实用且简单的文件编辑工具,使发布更加轻松!通过 /ws 打开管理 GUI
- 重命名文件或文件夹(快捷键 1)
- 压缩文件夹(快捷键 2)
- 解压压缩包(快捷键 4)
- 删除文件或文件夹(快捷键 3)
此外,你还可以直接查看文件信息,如文件大小、文件类型(以物品颜色高亮显示)、最后编辑时间和路径。
资源包集成
一键将资源包文件夹或压缩包直接发送给其他玩家。这允许你修改资源包并即时更新给玩家,无需打包和上传。
- 复制你的资源包文件夹/压缩包的路径
- 输入
/ws texturepack "<path>" <target>
- 目标玩家首次必须接受资源包
你也可以通过在命令末尾添加 true 来强制玩家使用该资源包。
例如:/ws texturepack "rp/test" @a true
技术信息与设置
MWeb 完全可定制,以适应你的需求。为了实现所有功能,MWeb 会在后台启动一个 Web 服务器来处理所有请求。这也意味着你需要开放第二个端口。如果你不知道这是什么或难以设置,请在 我们的 Discord 服务器 询问我们。
重要提示 - 每个操作都受特定权限限制(文档)以确保文件安全。OP(管理员)可以绕过所有权限!我们强烈建议你使用像 luckperms 这样的权限管理器!
你不希望链接中包含数字 IP 吗?请使用 nginx 等代理管理器,并将其配置到 mweb 配置文件中。需要帮助吗?和之前一样,你可以 询问我们。
API
你想在你的插件/模组中使用 MWeb 的功能吗?借助我们的 API,你可以创建和管理*链接,甚至利用我们的资源包功能动态创建和发送资源包!使用 Kotlin 可获得最佳体验(使用 Java 调用我们的 API 也可以,但体验稍差)
dependencies {
compileOnly("de.miraculixx:mweb:1.1.0")
}
API 位于 Maven Central。请勿将其阴影化(shade)到你的项目中!
MWeb
Don't want to read everything? Click on the spoiler below for a compact feature overview.
For developers that are interested into the MWeb API, scroll down to the bottom.
MWeb Feature Summary
MWeb can be controlled completely by GUI or command.
You can...
- ...browse through your files ingame (GUI only)
- ...create public links to any file or folder on your server
- ...create restricted links to any file or folder on your server (user, passphrase, timed, amount)
- ...edit and toggle all created links
- ...send folders or archives directly to players as resource pack
- ...zip & unzip folders/archives ingame
- ...delete & rename files ingame
- ...define folders for uploading files (can be restricted like downloads)
And for the more technical features, you can also...
- ...respond custom html/css/js on error pages
- ...define a proxy domain (like mutils.net/<id> instead of 1.2.3.4:1234/<id>)
- ...restrict every single action to a permission
The detailed description & guide is sorted into the following categories
- Creating download link
- Manage files
- Resource Pack integration
- Technical information & setup
To view all permissions and further help, visit mutils.net/mweb
This project cost a lot of work, any support is highly appreciated!
Create download link
Creating a simple download link isn't more then one click!
- Open the whitelist GUI (
/ws whitelist or /ws -> manage download access)
- Navigate to your file or folder
- Press a displayed button to create a link
You can create a global link or personal link (only usable by you) directly from the navigator by using your 1 & 2 hotkey. After processing (bigger folders take some time to zip) a new link is generated for you. Click on copy to copy the link in your clipboard and share it with anyone or paste it in your browser!
You can create multiple links for the same file. Press your 4 hotkey on a file or folder to manage all links. Here you can toggle, remove or even edit existing links.
(the preview use mweb.mutils.net as proxy. This is not a default behaviour)
Manage files
MWeb also adds helpful and simple file editing tools to make publishing easier! Open the mange GUI with /ws
- Rename files or folders (Hotkey 1)
- Zip folders (Hotkey 2)
- Unzip archives (Hotkey 4)
- Delete files or folders (Hotkey 3)
Additionally you can directly see file information like file size, file type (highlighted with item color), last edited and the path.
Resource pack integration
Send resource pack folders or archives directly to other players with one click. That allows you to modify your resource pack and update players instantly without the need of packing & uploading.
- Copy the path of your resource pack folder/archive
- Enter
/ws texturepack "<path>" <target>
- Targets must accept resource packs at the first time
You can also force players to use the resource pack by adding true at the end of the command.
E.g. /ws texturepack "rp/test" @a true
Technical information & setup
MWeb is completely customizable and adapt to your needs. To make everything possible, MWeb starts a web server in the background to manage all requests. That also means you need a second open port. If you don't know what that is or have troubles to set it up ask us at our discord server.
Important - Every action is restricted to a certain permission (docs) to secure your files. OP bypasses all permissions! We highly recommend you to use permission manager like luckperms!
You don't want the number ip in your link? Use a proxy manager like nginx and enter it in the mweb config. Need help? Like before you can ask us.
API
You want to use features from MWeb in your plugin/mod? With our API you can create and manage* links
and even use our resource pack feature to dynamically create and send resource packs! Get the best experience by using Kotlin (using our api in java works too but is less enjoyable)
dependencies {
compileOnly("de.miraculixx:mweb:1.1.0")
}
The API is located at maven central. Do not shade it into your project!
评论 0
登录后参与评分
还没有评论,来抢沙发吧