MorePractice Malody Server

State:

master

dev

Basic

API version：202103
Application version：1.0.3
Runtime：ASP.NET Core

An open-source Malody V Chart Server. Can be run on low loads, but surely booms at high loads.
You can use it as you download, no need configuration, and it can run the server using sqlite and local file system.

Features

Features Now Usable:

• Charts upload/download
• Charts Searching (using Keywords or id)
• Chart list
• Promotion list
• Saves file on local server
• Event list
• Supports MySql/SQLServer/sqlite

Currently Known Bugs:

• All right :)

Features Under Construction：

• Supports api version 202108

Will be Added：

• Upload identity restructions
• User identity restructions
• Save on third-party device or website
• Supports api version 202108
• Supports docker
• Frontend management page

Installation

You can install it in two ways: binary or compile from source code.

Binary：

1. Download the latest binary files at release page.
2. Decompress it, modify the profile.
3. Run MorePracticeMalodyServer. File names is slightly different depending on the platform.

• Linux: MorePracticeMalodyServer
• Windows: MorePracticeMalodyServer.exe

Compile from Source Code：

1. Clone or download MorePracticeMalodyServer repo.
2. Make sure you have installed .NET 5 SDK. You can download from here. You can read this to get the way about installing .NET 5 SDK.
3. Run dotnet restore.
4. Uses sqlite as database and local filesystem as storage by default. If using other providers, please refer to [Modifying the profile](#Modifying the profile).
5. As the database provider changing, Please delete ALL THINGS under MorePracticeMalodyServer\Migrations, then run dotnet ef migrations add InitialCreate and dotnet ef database update to update it. For production environment databases, dotnet ef migrations script --idempotent is promoted, while generates the SQL script to construct the data table.
6. Run dotnet build --configuration Release --no-restore to build.
7. Copy bulit files at MorePracticeMalodyServer\bin\Release.

Modifying the Profile

Profile: appsettings.json. The following are the structure and modify ways:

• Logging
  • LogLevel : Set Warning to reduce logs
    • Default
    • Microsoft
    • Microsoft.Hosting.Lifetime
  • Data : setup databases
    • Provider : Database provider, you can set to sqlserver,mysql,sqlite. sqlite is default.
    • PoolSize : The maximum connection number of connection pool.
    • ConnectionString : Strings of connection. Refer to databases' documentation.
    • ServerVersion : Used by MySql, define version.
  • Storage : setup storage
    • Provider : The storage provider link. Local storage is self. For information on how to extend storage provisioning, refer to the section on [custom storage provisioning](#Custom Storage Provisioning).

Notes for Modifying the Database Provider

If you modify the database provider, you must use source code compilation to build database migrations and database scripts to build your data tables.
Refer to Compile from Source Code in Installation. Now only sqlite is tested, as a result, other providers may behave unpredictably. If an exception occurs while the program is in use，please open a new issue.

Custom Storage Provisioning

This is now under construction!
Please set Storage:Provider as the upload interface for your file provider. Callback the server with the file link after the upload is complete.(This callback is under construction)
Games use application/x-www-form-urlencoded to send file. Only one file with meta info is sent at a time. meta info is text key-value. We provides the cid, sid and hash. It can be retrieved in the form. As the files are saved on your storage provider, the server won't try to download your files to analyze. You need to parse the metadata of chart files | *.mc. After parsing, call server api to upload it(This Api is under construstion).

Docker support

Application can be run on docker. Although docker images are not currently packaged, there is dockerfile, so you need to run docker build.
Servers running on docker don't support neither local filesystem nor sqlite. Please replace the database provider with the storage provider. About how to do this, [refer to this]('#Notes for Modifying the Database Provider').

License

This program uses GPL v3.0 (GNU GENERAL PUBLIC LICENSE v3.0) Agreement. By using this program or source code, you understand and agree to this agreement.

Microsoft.EntityFrameworkCore

• Apache-2.0

Microsoft.EntityFrameworkCore.Sqlite

• Apache-2.0

Microsoft.EntityFrameworkCore.SqlServer

• Apache-2.0

Microsoft.EntityFrameworkCore.Tools

• Apache-2.0

Microsoft.VisualStudio.Azure.Containers.Tools.Targets

• MICROSOFT SOFTWARE LICENSE TERMS

Pomelo.EntityFrameworkCore.MySql

• MIT

NVorbis

• Mit

Special thanks to

• @soloopooo