caret/ll-hax-docs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ll-hax-docs/sifas/index.html
BuildTools 1921a563ed Fixed
2023-07-25 20:33:42 -05:00

1907 lines
No EOL
78 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="canonical" href="https://ll.hax.sif.moe/sifas/">
<link rel="prev" href="../sifac/">
<link rel="next" href="../sif2/">
<link rel="icon" href="../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.4.3, mkdocs-material-9.1.19">
<title>SIFAS - LL Hax Docs</title>
<link rel="stylesheet" href="../assets/stylesheets/main.eebd395e.min.css">
<link rel="stylesheet" href="../assets/stylesheets/palette.ecc896b0.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<link rel="stylesheet" href="../style/better.css">
<script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="pink" data-md-color-accent="deep-purple">
<script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#sifas" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href=".." title="LL Hax Docs" class="md-header__button md-logo" aria-label="LL Hax Docs" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
LL Hax Docs
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
SIFAS
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="pink" data-md-color-accent="deep-purple" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
</label>
<input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="pink" data-md-color-accent="deep-purple" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_2">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
</label>
</form>
<div class="md-header__option">
<div class="md-select">
<button class="md-header__button md-icon" aria-label="Select language">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m12.87 15.07-2.54-2.51.03-.03A17.52 17.52 0 0 0 14.07 6H17V4h-7V2H8v2H1v2h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04M18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12m-2.62 7 1.62-4.33L19.12 17h-3.24Z"/></svg>
</button>
<div class="md-select__inner">
<ul class="md-select__list">
<li class="md-select__item">
<a href="/en/" hreflang="en" class="md-select__link">
English
</a>
</li>
<li class="md-select__item">
<a href="/ja/" hreflang="ja" class="md-select__link">
日本語
</a>
</li>
<li class="md-select__item">
<a href="/zh_CN/" hreflang="zh_CN" class="md-select__link">
中国人
</a>
</li>
</ul>
</div>
</div>
</div>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href=".." title="LL Hax Docs" class="md-nav__button md-logo" aria-label="LL Hax Docs" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
LL Hax Docs
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href=".." class="md-nav__link">
Home
</a>
</li>
<li class="md-nav__item">
<a href="../pugu/" class="md-nav__link">
Puchiguru
</a>
</li>
<li class="md-nav__item">
<a href="../sif/" class="md-nav__link">
SIF
</a>
</li>
<li class="md-nav__item">
<a href="../sifac/" class="md-nav__link">
SIFAC
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
SIFAS
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
SIFAS
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#sifas" class="md-nav__link">
SIFAS
</a>
</li>
<li class="md-nav__item">
<a href="#some_random_forewords" class="md-nav__link">
Some random forewords
</a>
</li>
<li class="md-nav__item">
<a href="#disclaimers" class="md-nav__link">
Disclaimers
</a>
</li>
<li class="md-nav__item">
<a href="#intents" class="md-nav__link">
Intents
</a>
</li>
<li class="md-nav__item">
<a href="#convention" class="md-nav__link">
Convention
</a>
</li>
<li class="md-nav__item">
<a href="#installing_the_client" class="md-nav__link">
Installing the client
</a>
<nav class="md-nav" aria-label="Installing the client">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#clients_version" class="md-nav__link">
Clients version
</a>
</li>
<li class="md-nav__item">
<a href="#basic_clients" class="md-nav__link">
Basic clients
</a>
</li>
<li class="md-nav__item">
<a href="#patching_client_to_a_different_server_address" class="md-nav__link">
Patching client to a different server address
</a>
<nav class="md-nav" aria-label="Patching client to a different server address">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#patching_android_client_to_different_server_address" class="md-nav__link">
Patching Android client to different server address
</a>
<nav class="md-nav" aria-label="Patching Android client to different server address">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#first_step_unpacking_the_apk" class="md-nav__link">
First step: Unpacking the apk
</a>
</li>
<li class="md-nav__item">
<a href="#second_step_change_the_address_string" class="md-nav__link">
Second step: Change the address string
</a>
</li>
<li class="md-nav__item">
<a href="#third_step_repack_the_apk" class="md-nav__link">
Third step: Repack the apk
</a>
</li>
<li class="md-nav__item">
<a href="#fourth_step_sign_the_apk" class="md-nav__link">
Fourth step: Sign the apk
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#patching_android_client_to_new_address_with_frida" class="md-nav__link">
Patching Android client to new address with frida
</a>
</li>
<li class="md-nav__item">
<a href="#patching_ios_client_to_new_address" class="md-nav__link">
Patching ios client to new address
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#install_the_elichika_server" class="md-nav__link">
Install the elichika server
</a>
<nav class="md-nav" aria-label="Install the elichika server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#platforms" class="md-nav__link">
Platforms
</a>
</li>
<li class="md-nav__item">
<a href="#zeroth_step_install_git_for_each_platform" class="md-nav__link">
Zeroth step: Install git for each platform
</a>
</li>
<li class="md-nav__item">
<a href="#first_step_download_the_server" class="md-nav__link">
First step: Download the server
</a>
<nav class="md-nav" aria-label="First step: Download the server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#using_git" class="md-nav__link">
Using git
</a>
</li>
<li class="md-nav__item">
<a href="#download_directly" class="md-nav__link">
Download directly
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#third_step_build_the_server" class="md-nav__link">
Third step: Build the server
</a>
<nav class="md-nav" aria-label="Third step: Build the server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#installing_go" class="md-nav__link">
Installing Go
</a>
</li>
<li class="md-nav__item">
<a href="#building_the_server" class="md-nav__link">
Building the server
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#running_the_server" class="md-nav__link">
Running the server
</a>
<nav class="md-nav" aria-label="Running the server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#providing_a_cdn_server" class="md-nav__link">
Providing a CDN server
</a>
<nav class="md-nav" aria-label="Providing a CDN server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#online_cdn" class="md-nav__link">
Online CDN
</a>
</li>
<li class="md-nav__item">
<a href="#self_hosted_cdn" class="md-nav__link">
Self hosted CDN
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#patching_the_database" class="md-nav__link">
Patching the database
</a>
</li>
<li class="md-nav__item">
<a href="#changing_server_port" class="md-nav__link">
Changing server port
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#playing_the_game" class="md-nav__link">
Playing the game
</a>
<nav class="md-nav" aria-label="Playing the game">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#stuff_that_works_at_least_partially" class="md-nav__link">
Stuff that works (at least partially)
</a>
<nav class="md-nav" aria-label="Stuff that works (at least partially)">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#personalization" class="md-nav__link">
Personalization
</a>
</li>
<li class="md-nav__item">
<a href="#partner_interaction" class="md-nav__link">
Partner interaction
</a>
</li>
<li class="md-nav__item">
<a href="#3dmv" class="md-nav__link">
3DMV
</a>
</li>
<li class="md-nav__item">
<a href="#story" class="md-nav__link">
Story
</a>
</li>
<li class="md-nav__item">
<a href="#live_show" class="md-nav__link">
Live show
</a>
</li>
<li class="md-nav__item">
<a href="#school_idols" class="md-nav__link">
School idols
</a>
</li>
<li class="md-nav__item">
<a href="#training" class="md-nav__link">
Training
</a>
</li>
<li class="md-nav__item">
<a href="#accessories" class="md-nav__link">
Accessories
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#stuff_that_doesnt_work_at_least_at_the_time_of_writing" class="md-nav__link">
Stuff that doesn't work (at least at the time of writing)
</a>
<nav class="md-nav" aria-label="Stuff that doesn't work (at least at the time of writing)">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#gacha" class="md-nav__link">
Gacha
</a>
</li>
<li class="md-nav__item">
<a href="#membership_card" class="md-nav__link">
Membership card
</a>
</li>
<li class="md-nav__item">
<a href="#news" class="md-nav__link">
News
</a>
</li>
<li class="md-nav__item">
<a href="#goals" class="md-nav__link">
Goals
</a>
</li>
<li class="md-nav__item">
<a href="#channel_member" class="md-nav__link">
Channel member
</a>
</li>
<li class="md-nav__item">
<a href="#shop_and_exchange" class="md-nav__link">
Shop and exchange
</a>
</li>
<li class="md-nav__item">
<a href="#multiplayer" class="md-nav__link">
Multiplayer
</a>
</li>
<li class="md-nav__item">
<a href="#event_sbl_and_dlp" class="md-nav__link">
Event, SBL, and DLP
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#future_of_the_server" class="md-nav__link">
Future of the server
</a>
</li>
<li class="md-nav__item">
<a href="#easy_install" class="md-nav__link">
Easy install
</a>
<nav class="md-nav" aria-label="Easy install">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#clients" class="md-nav__link">
Clients
</a>
</li>
<li class="md-nav__item">
<a href="#servers" class="md-nav__link">
Servers
</a>
</li>
<li class="md-nav__item">
<a href="#common_setups" class="md-nav__link">
Common setups
</a>
<nav class="md-nav" aria-label="Common setups">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#server_and_client_run_on_android_with_termux" class="md-nav__link">
Server and client run on Android, with Termux
</a>
</li>
<li class="md-nav__item">
<a href="#server_on_pc_play_on_phone_through_wi-fi" class="md-nav__link">
Server on PC, play on phone, through Wi-Fi
</a>
</li>
<li class="md-nav__item">
<a href="#server_on_pc_play_on_android_phone_through_adb" class="md-nav__link">
Server on PC, play on android phone, through adb
</a>
</li>
<li class="md-nav__item">
<a href="#server_on_pc_play_on_android_emulator" class="md-nav__link">
Server on PC, play on android emulator
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#random_knowledge" class="md-nav__link">
Random knowledge
</a>
<nav class="md-nav" aria-label="Random knowledge">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#install_necessary_program_in_linuxmactermux" class="md-nav__link">
Install necessary program in Linux/Mac/Termux
</a>
</li>
<li class="md-nav__item">
<a href="#installing_apk" class="md-nav__link">
Installing .apk
</a>
</li>
<li class="md-nav__item">
<a href="#installing_ipa" class="md-nav__link">
Installing .ipa
</a>
</li>
<li class="md-nav__item">
<a href="#installing_termux_for_android" class="md-nav__link">
Installing termux (for android)
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../sif2/" class="md-nav__link">
SIF2
</a>
</li>
<li class="md-nav__item">
<a href="../about/" class="md-nav__link">
About
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#sifas" class="md-nav__link">
SIFAS
</a>
</li>
<li class="md-nav__item">
<a href="#some_random_forewords" class="md-nav__link">
Some random forewords
</a>
</li>
<li class="md-nav__item">
<a href="#disclaimers" class="md-nav__link">
Disclaimers
</a>
</li>
<li class="md-nav__item">
<a href="#intents" class="md-nav__link">
Intents
</a>
</li>
<li class="md-nav__item">
<a href="#convention" class="md-nav__link">
Convention
</a>
</li>
<li class="md-nav__item">
<a href="#installing_the_client" class="md-nav__link">
Installing the client
</a>
<nav class="md-nav" aria-label="Installing the client">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#clients_version" class="md-nav__link">
Clients version
</a>
</li>
<li class="md-nav__item">
<a href="#basic_clients" class="md-nav__link">
Basic clients
</a>
</li>
<li class="md-nav__item">
<a href="#patching_client_to_a_different_server_address" class="md-nav__link">
Patching client to a different server address
</a>
<nav class="md-nav" aria-label="Patching client to a different server address">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#patching_android_client_to_different_server_address" class="md-nav__link">
Patching Android client to different server address
</a>
<nav class="md-nav" aria-label="Patching Android client to different server address">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#first_step_unpacking_the_apk" class="md-nav__link">
First step: Unpacking the apk
</a>
</li>
<li class="md-nav__item">
<a href="#second_step_change_the_address_string" class="md-nav__link">
Second step: Change the address string
</a>
</li>
<li class="md-nav__item">
<a href="#third_step_repack_the_apk" class="md-nav__link">
Third step: Repack the apk
</a>
</li>
<li class="md-nav__item">
<a href="#fourth_step_sign_the_apk" class="md-nav__link">
Fourth step: Sign the apk
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#patching_android_client_to_new_address_with_frida" class="md-nav__link">
Patching Android client to new address with frida
</a>
</li>
<li class="md-nav__item">
<a href="#patching_ios_client_to_new_address" class="md-nav__link">
Patching ios client to new address
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#install_the_elichika_server" class="md-nav__link">
Install the elichika server
</a>
<nav class="md-nav" aria-label="Install the elichika server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#platforms" class="md-nav__link">
Platforms
</a>
</li>
<li class="md-nav__item">
<a href="#zeroth_step_install_git_for_each_platform" class="md-nav__link">
Zeroth step: Install git for each platform
</a>
</li>
<li class="md-nav__item">
<a href="#first_step_download_the_server" class="md-nav__link">
First step: Download the server
</a>
<nav class="md-nav" aria-label="First step: Download the server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#using_git" class="md-nav__link">
Using git
</a>
</li>
<li class="md-nav__item">
<a href="#download_directly" class="md-nav__link">
Download directly
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#third_step_build_the_server" class="md-nav__link">
Third step: Build the server
</a>
<nav class="md-nav" aria-label="Third step: Build the server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#installing_go" class="md-nav__link">
Installing Go
</a>
</li>
<li class="md-nav__item">
<a href="#building_the_server" class="md-nav__link">
Building the server
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#running_the_server" class="md-nav__link">
Running the server
</a>
<nav class="md-nav" aria-label="Running the server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#providing_a_cdn_server" class="md-nav__link">
Providing a CDN server
</a>
<nav class="md-nav" aria-label="Providing a CDN server">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#online_cdn" class="md-nav__link">
Online CDN
</a>
</li>
<li class="md-nav__item">
<a href="#self_hosted_cdn" class="md-nav__link">
Self hosted CDN
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#patching_the_database" class="md-nav__link">
Patching the database
</a>
</li>
<li class="md-nav__item">
<a href="#changing_server_port" class="md-nav__link">
Changing server port
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#playing_the_game" class="md-nav__link">
Playing the game
</a>
<nav class="md-nav" aria-label="Playing the game">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#stuff_that_works_at_least_partially" class="md-nav__link">
Stuff that works (at least partially)
</a>
<nav class="md-nav" aria-label="Stuff that works (at least partially)">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#personalization" class="md-nav__link">
Personalization
</a>
</li>
<li class="md-nav__item">
<a href="#partner_interaction" class="md-nav__link">
Partner interaction
</a>
</li>
<li class="md-nav__item">
<a href="#3dmv" class="md-nav__link">
3DMV
</a>
</li>
<li class="md-nav__item">
<a href="#story" class="md-nav__link">
Story
</a>
</li>
<li class="md-nav__item">
<a href="#live_show" class="md-nav__link">
Live show
</a>
</li>
<li class="md-nav__item">
<a href="#school_idols" class="md-nav__link">
School idols
</a>
</li>
<li class="md-nav__item">
<a href="#training" class="md-nav__link">
Training
</a>
</li>
<li class="md-nav__item">
<a href="#accessories" class="md-nav__link">
Accessories
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#stuff_that_doesnt_work_at_least_at_the_time_of_writing" class="md-nav__link">
Stuff that doesn't work (at least at the time of writing)
</a>
<nav class="md-nav" aria-label="Stuff that doesn't work (at least at the time of writing)">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#gacha" class="md-nav__link">
Gacha
</a>
</li>
<li class="md-nav__item">
<a href="#membership_card" class="md-nav__link">
Membership card
</a>
</li>
<li class="md-nav__item">
<a href="#news" class="md-nav__link">
News
</a>
</li>
<li class="md-nav__item">
<a href="#goals" class="md-nav__link">
Goals
</a>
</li>
<li class="md-nav__item">
<a href="#channel_member" class="md-nav__link">
Channel member
</a>
</li>
<li class="md-nav__item">
<a href="#shop_and_exchange" class="md-nav__link">
Shop and exchange
</a>
</li>
<li class="md-nav__item">
<a href="#multiplayer" class="md-nav__link">
Multiplayer
</a>
</li>
<li class="md-nav__item">
<a href="#event_sbl_and_dlp" class="md-nav__link">
Event, SBL, and DLP
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#future_of_the_server" class="md-nav__link">
Future of the server
</a>
</li>
<li class="md-nav__item">
<a href="#easy_install" class="md-nav__link">
Easy install
</a>
<nav class="md-nav" aria-label="Easy install">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#clients" class="md-nav__link">
Clients
</a>
</li>
<li class="md-nav__item">
<a href="#servers" class="md-nav__link">
Servers
</a>
</li>
<li class="md-nav__item">
<a href="#common_setups" class="md-nav__link">
Common setups
</a>
<nav class="md-nav" aria-label="Common setups">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#server_and_client_run_on_android_with_termux" class="md-nav__link">
Server and client run on Android, with Termux
</a>
</li>
<li class="md-nav__item">
<a href="#server_on_pc_play_on_phone_through_wi-fi" class="md-nav__link">
Server on PC, play on phone, through Wi-Fi
</a>
</li>
<li class="md-nav__item">
<a href="#server_on_pc_play_on_android_phone_through_adb" class="md-nav__link">
Server on PC, play on android phone, through adb
</a>
</li>
<li class="md-nav__item">
<a href="#server_on_pc_play_on_android_emulator" class="md-nav__link">
Server on PC, play on android emulator
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#random_knowledge" class="md-nav__link">
Random knowledge
</a>
<nav class="md-nav" aria-label="Random knowledge">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#install_necessary_program_in_linuxmactermux" class="md-nav__link">
Install necessary program in Linux/Mac/Termux
</a>
</li>
<li class="md-nav__item">
<a href="#installing_apk" class="md-nav__link">
Installing .apk
</a>
</li>
<li class="md-nav__item">
<a href="#installing_ipa" class="md-nav__link">
Installing .ipa
</a>
</li>
<li class="md-nav__item">
<a href="#installing_termux_for_android" class="md-nav__link">
Installing termux (for android)
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1>SIFAS</h1>
<h2 id="sifas">SIFAS<a class="headerlink" href="#sifas" title="Permanent link">&para;</a></h2>
<p>(the following was copied from the fandom wiki)</p>
<p>Love Live! School Idol Festival ALL STARS (ラブライブ！スクールアイドルフェスティバル ALL STARS Rabu raibu! Sukūru Aidoru Fesutibaru ALL STARS) was a rhythm action game developed for mobile platforms, based on the Love Live! and related franchises. It is published by Bushiroad and developed by KLab Inc., and was released on September 26, 2019. It was first announced at Tokyo Game Show 2017 on September 21, 2017. Prior to the announcement, it was first introduced and teased on March 30, 2017 as the PERFECT Dream Project in conjunction with SIF's 4th year anniversary.
Love Live! School Idol Festival ALL STARS was designed with "the greatest, best idol game" as its concept. Characters from μ’s, Aqours and Nijigasaki High School Idol Club appear within this game.</p>
<p>On April 30, 2023, it was announced that the game's service would be shut down on June 30, 2023.</p>
<h2 id="some_random_forewords">Some random forewords<a class="headerlink" href="#some_random_forewords" title="Permanent link">&para;</a></h2>
<p>SIFAS, whether you liked it or not, was unjustly killed in favor of a bad "sequel". SIFAS die and bring with it things like fully animated navigator, stories, costume, and of course the main selling point of the game - 3DMV. With SIFAS gone, the only way to officially watch 3DMV is through the Link Live app (doesn't have other groups), or through some metaverse VR stuff that you have to pay for (per concert).</p>
<p>Luckily for us, the community managed to preserve most if not all of the beloved aspects of the game. Thanks to various community members, there are works done and being done so that with a bit of tinkering, you can install and play SIFAS.</p>
<h2 id="disclaimers">Disclaimers<a class="headerlink" href="#disclaimers" title="Permanent link">&para;</a></h2>
<p>The information presented by the author(s) of this documentation were either background knowledge, knowledge provided by community members, or knowledge learned from works published by community members.</p>
<p>The author(s) try to make sure that the information presented is correct. However, there might be incorrect info, or outdated info.</p>
<p>The author(s) try to acknowledge and credit the community members who share knowledge, develop tools, host resources, or helped in any other way, but there might be some missing credit. If that were the case, please know that it is not intended by the author(s), and please contact the author(s) for proper credit.</p>
<p>The knowledge, tools, resources used by this documentation are acquired and presented with a good faith basis. While the author(s) try to ask creators for permission to use or feature their works, some works was used or featured without explicit permission. If you have problem with your works being mentioned / features, or your name being credited, please contact the author(s) to sort things out.</p>
<h2 id="intents">Intents<a class="headerlink" href="#intents" title="Permanent link">&para;</a></h2>
<p>This documentation go somewhat in depth to the technical side, so for experienced audience, it can serve as a quick introduction to the working of the game and server. If you are not interested in the details, or want to get something running before learning more, please check out the <a href="#easy-install">Easy install</a> section for a streamlined experience. Do note that the provided packages might not work for you, however, the details explanation should give you want you need to get things working. Regardless, feel free to reach out to the community, both to help resolve your situation and to help make the documentation better.</p>
<p>This documentation will be about hosting your own SIFAS server, however, there exist a Korean private server that you can play the GL version on. You can find out more about it by asking in the LL Hax server. This documentation will also discuss only the GL (Global) and JP (Japanese) version, although there exist private server for CN (Chinese) version as well.</p>
<p>This documentation assume that you have some background knowledge related to the topic discussed, however, if this is your first time doing something like this, or you just want to learn more, you can also checkout the <a href="#random-knowledge">Random knowledge</a> section. Various things that are common knowledge, things that are related and interesting (but not totally relevant to the discussion) are discussed.</p>
<h2 id="convention">Convention<a class="headerlink" href="#convention" title="Permanent link">&para;</a></h2>
<p>As there are multiple platforms for both client and server, we use the following terms to refer to them:</p>
<ul>
<li>Client: The game/app itself. This is what you will use to play the game.</li>
<li>Server: The program that serve the necessary data for client(s) to function. This was Klab/MYNET/Bushiroad responsibility, but we will have to run our own server now that they have stoped supporting the game. The server often run in another machine, but there are setup that run the client and server on the same machine for android.</li>
<li>Android/iOS/android/ios: The platform that the client run on. You should know what your platform is.</li>
<li>Window/Linux/MacOS/Android: The platform that the server will run on.</li>
</ul>
<h2 id="installing_the_client">Installing the client<a class="headerlink" href="#installing_the_client" title="Permanent link">&para;</a></h2>
<h3 id="clients_version">Clients version<a class="headerlink" href="#clients_version" title="Permanent link">&para;</a></h3>
<p>We will be using the 3.12 clients (patched):
- If you recall, these are released after the game is dead.
- The only functionality is to show a "SIFAS EoS, thanks for playing SIFAS" message, or so it seems.
- The truth is that, none of the original functionality was deleted, but the crack-proof is removed.
- Which mean that if we patch the starting screen away, we have access to a superior version of the app.
- We will only deal with the patched version here, the only modification you might need to do is to change the server address inside the client.</p>
<h3 id="basic_clients">Basic clients<a class="headerlink" href="#basic_clients" title="Permanent link">&para;</a></h3>
<p>These are the clients that come with the <a href="https://github.com/YumeMichi/elichika">elichika server</a>, you can get them from<a href="https://github.com/YumeMichi/elichika">elichika</a> or directly <a href="https://mega.nz/folder/gwJizZjS#v_fSOadf9yrb_eaOze2r7Q">here</a>.</p>
<p>These clients connect to http://192.168.1.123. This is a local address (LAN), so if you run <code>elichika</code> the machine that has that address (and the port is opened for LAN access), you won't have to modify the clients at all. It will be explained more on the <a href="#easy-install">easy install section</a>.</p>
<h3 id="patching_client_to_a_different_server_address">Patching client to a different server address<a class="headerlink" href="#patching_client_to_a_different_server_address" title="Permanent link">&para;</a></h3>
<p>There are some problems that prevent the basic clients from working or working well:
- You might not have a Wi-Fi network that you can connect to.
- You might not have a separate device (usually a PC / laptop) to run the server on.
- Your Wi-Fi router IP address might not look like 192.168.xxx.xxx, and it's impossible or very complicated to change that.
- You can't obtain the IP 192.168.1.123 because someone or something on your network already have that (it's a nice address).
- You have the IP but you need port 80 (default http) for something else, so you can't run <code>elichika</code> on that port.
- You are outside touching grass a lot, so you are not connected to Wi-Fi that often.
- The list go on.</p>
<p>In which case, you will need to patch the server address in your client, or a client with different address. There are a few clients provided in the <a href="#easy-install">easy install section</a>, see if you can use one of them, if not then you will have to patch the server address yourself.</p>
<h4 id="patching_android_client_to_different_server_address">Patching Android client to different server address<a class="headerlink" href="#patching_android_client_to_different_server_address" title="Permanent link">&para;</a></h4>
<p>This part is written after referencing <a href="https://github.com/YumeMichi/honoka-chan/blob/master/doc/3.md">honoka-chan</a>. It's recommended that you read that for a deeper understanding, however that won't be necessary to follow this documentation.</p>
<p>We work with the basic clients <code>.apk</code> here.</p>
<h5 id="first_step_unpacking_the_apk">First step: Unpacking the apk<a class="headerlink" href="#first_step_unpacking_the_apk" title="Permanent link">&para;</a></h5>
<p>There are multiple ways to do this, but we will use <a href="https://apktool.org/">apktool</a>.</p>
<p>We can either use the wrapper or .jar directly. Of course, <a href="https://www.java.com">java</a> will be necessary.</p>
<p>Open up a terminal (command prompt) in the same folder as the <code>.apk</code> and run the following:</p>
<pre><code>apktool d ALL_STARS_3.12.0_gl_patched.apk
</code></pre>
<p>for global client, or </p>
<pre><code>apktool d ALL_STARS_3.12.0_ja_patched.apk
</code></pre>
<p>for JP client. Note that if you don't use or don't have the <code>apktool</code> wrapper, you can run the <code>.jar</code> directly (put in the same directory or you will have to specify to the actual path):</p>
<pre><code>java -jar apktool_2.8.1.jar d apkname.apk
</code></pre>
<p>In any case, after unpacking, you should have a folder that has the same name as the <code>.apk</code> except for the extension</p>
<h5 id="second_step_change_the_address_string">Second step: Change the address string<a class="headerlink" href="#second_step_change_the_address_string" title="Permanent link">&para;</a></h5>
<p>We will use the <a href="https://github.com/JeremieCHN/MetaDataStringEditor">MetaData String Editor</a></p>
<p>It is written in C#, and the <code>.exe</code> you can download need windows to run. If you can build your own from source, or change the metadata in other way, then you can use that too.</p>
<p>This tool is used to edit the metadata file of Unity engine games. In this case, we use it to change the address the client will connect to, but you can also change other strings.</p>
<!-- TODO: Maybe insert some photo. -->
<p>To change the address string, open the tool, then press the top left button and open up the <code>global-metadata.dat</code> file. You can find it in:</p>
<pre><code>ALL_STARS_3.12.0_gl_patched\assets\bin\Data\Managed\Metadata
</code></pre>
<p>or </p>
<pre><code>ALL_STARS_3.12.0_jp_patched\assets\bin\Data\Managed\Metadata
</code></pre>
<p>depending on the versions.</p>
<p>You will see many strings. Search for http://192.168.1.123 using the textbox at the top. Double click on the string, click on the popup thing, and you will see another window pop up. You can edit that data to any address you wish to connect to.</p>
<p>If want to use the <a href="https://github.com/YumeMichi/elichika">elichika</a> server, keep it <code>http</code>, you can use <code>https</code> if the server do support that.</p>
<p>After editing the address, click the bottom right button to change the address. After that, click the middle button on the top left of the program. Save the metadata as some other file, as you can't overwrite to the current file. After that you can close the tool, remove the original <code>global-metadata.dat</code> and rename the new file to <code>global-metadata.dat</code>. </p>
<h5 id="third_step_repack_the_apk">Third step: Repack the apk<a class="headerlink" href="#third_step_repack_the_apk" title="Permanent link">&para;</a></h5>
<p>We can do this with <code>apktool</code>:</p>
<pre><code>apktool b ALL_STARS_3.12.0_gl_patched
</code></pre>
<p>or </p>
<pre><code>apktool b ALL_STARS_3.12.0_ja_patched
</code></pre>
<p>After <code>apktool</code> is done, you can find the output <code>.apk</code> in </p>
<pre><code>ALL_STARS_3.12.0_gl_patched\dist\ALL_STARS_3.12.0_gl_patched.apk
</code></pre>
<p>or </p>
<pre><code>ALL_STARS_3.12.0_jp_patched\dist\ALL_STARS_3.12.0_jp_patched.apk
</code></pre>
<p>This <code>.apk</code> is not finished, we need to sign it before it can be installed in emulators or phones.</p>
<h5 id="fourth_step_sign_the_apk">Fourth step: Sign the apk<a class="headerlink" href="#fourth_step_sign_the_apk" title="Permanent link">&para;</a></h5>
<p>To sign the <code>.apk</code>, we will need a few things.</p>
<p>The first is <code>apksigner</code>. You can either download a <code>.jar</code> online, or you can get it with the <a href="https://developer.android.com/studio">Android SDK</a>.</p>
<p>The second thing we need is a keystore. You can download this <a href="https://codeberg.org/arina999999997/nozomi/raw/branch/master/sifkey.keystore">keystore</a> that has password <code>123456</code> for your convinience. If you want to generate your own key store, you will need <code>keytool</code>, which come with <code>java</code> (find it in java bin folder):</p>
<pre><code>keytool -genkeypair -v -keystore sifkey.keystore -alias sifkey -keyalg RSA -keysize 2048 -validity 36500
</code></pre>
<p>You can choose your own password and the keystore name. After we have the keystore, you can sign the <code>.apk</code>:</p>
<pre><code>apksigner sign --ks sifkey.keystore --ks-key-alias sifkey --out ALL_STARS_3.12.0_gl_patched.apk ALL_STARS_3.12.0_gl_patched\dist\ALL_STARS_3.12.0_gl_patched.apk
</code></pre>
<p>You can change the <code>.apk</code> name if necessary.</p>
<p>After this, you can install the <code>.apk</code>. If you already have a version of SIFAS, you might get an error saying that the signature doesn't match. You can just uninstall the old SIFAS and install the new one in that case. Google play protect might say the file is suspicious, but you can still install it.</p>
<h4 id="patching_android_client_to_new_address_with_frida">Patching Android client to new address with frida<a class="headerlink" href="#patching_android_client_to_new_address_with_frida" title="Permanent link">&para;</a></h4>
<p>It's possible to use <a href="https://github.com/vfsfitvnm/frida-il2cpp-bridge">frida</a> to change the address and avoid having to patch the <code>.apk</code>, as demonstated by <code>sarah</code> in the LL Hax discord. If you don't want to use the above patching process, you might want to try that.</p>
<h4 id="patching_ios_client_to_new_address">Patching ios client to new address<a class="headerlink" href="#patching_ios_client_to_new_address" title="Permanent link">&para;</a></h4>
<p>The details on patching <code>.ipa</code> is outside of the author(s) knowledge and is not discussed here, but it is doable.</p>
<p>The ios clients distributed by <code>elichika</code> were patched by <code>tungnotpunk</code> in the LL Hax discord. If you want to learn how patch them yourself, you can find out more there.</p>
<h2 id="install_the_elichika_server">Install the elichika server<a class="headerlink" href="#install_the_elichika_server" title="Permanent link">&para;</a></h2>
<p><a href="https://github.com/YumeMichi/elichika">elichika</a> is a SIFAS server written by <code>YumeMichi</code> (<code>.yumemichi</code> on discord). It is written in Go(lang), and it is still being worked on at the time of writing this documentation. As such, it's recommended that you install <a href="https://git-scm.com/">git</a> to make it easy to keep your version up-to-date.</p>
<p>This documentation will walk through the process of installing and building <code>elichika</code> using <code>git</code> and some other tools. You can also try the <a href="#easy-install">prebuilt server binaries</a> but they might not be up to date, and might not work for your purpose.</p>
<h3 id="platforms">Platforms<a class="headerlink" href="#platforms" title="Permanent link">&para;</a></h3>
<p>Generally, if we can run Go on a platform, then we can run the server on it. Regardless of the platform, the setup will be something like this:
- Local PC: server run on a PC (windows, linux, mac), client connect to it through WLAN (Wi-Fi) or some tethering method.
- External PC: server run on an external machine, client connect to it through a public IP or a server address. This is the setup for online multiplayers, however that is not supported by the server (for now).
- Android/Termux: server run on the same android phone, tablet, or emulator as the client. More precisely, it will be running inside the <a href="#installing-termux-for-android">termux</a> app.</p>
<h3 id="zeroth_step_install_git_for_each_platform">Zeroth step: Install git for each platform<a class="headerlink" href="#zeroth_step_install_git_for_each_platform" title="Permanent link">&para;</a></h3>
<p>If you want to use <code>git</code> to get the server, and you didn't have it installed, you can download and install through the <a href="https://git-scm.com/downloads">official website</a>.</p>
<p>For Linux and Termux, you can also install <code>git</code> through the terminal (it's most likely already installed in Linux, but this is necessary for a fresh Termux install):</p>
<pre><code>apt install git
</code></pre>
<p>If you don't want to use it, you can skip this step.</p>
<h3 id="first_step_download_the_server">First step: Download the server<a class="headerlink" href="#first_step_download_the_server" title="Permanent link">&para;</a></h3>
<h4 id="using_git">Using git<a class="headerlink" href="#using_git" title="Permanent link">&para;</a></h4>
<p>Nagivate to where you want to put the server and open up a terminal:
- For Windows, nagivate with the GUI to the folder you want to put the server, then enter <code>cmd`` into the address bar, that will open up a terminal inside that folder.
- For Linux GUI, you can also navigate to the directory you want, and right click, there should be an option to open the terminal.
- For all platforms, you can also just open the command prompt / terminal and go to the correct place. Expect to use things like</code>cd<code>and</code>mkdir` to navigate and create folder.</p>
<p>After that, use <code>git clone</code> to download the server:</p>
<pre><code>git clone https://github.com/YumeMichi/elichika
</code></pre>
<p>You will get an <code>elichika</code> folder / directory. Go to it with your current terminal:</p>
<pre><code>cd elichika
</code></pre>
<p>Everyt ime you want to run the server, you will have to open a terminal in that directory.</p>
<p>If you use git, you can keep your server source code up to date by running the following:</p>
<pre><code>git pull
</code></pre>
<p>Note that if you made changes to the server, then <code>git pull</code> might fail. You can either learn more about <code>.gitignore</code> (or other methods) to keep your changes, or you can just run:</p>
<pre><code>git reset --hard
git pull
</code></pre>
<p>to update it, but you will have to make the change again.</p>
<h4 id="download_directly">Download directly<a class="headerlink" href="#download_directly" title="Permanent link">&para;</a></h4>
<p>You can also download the source code directly to avoid using <code>git</code>. If you do this, everytime you want to update the server, you will have to redownload everything.</p>
<p>Simply go to <a href="https://github.com/YumeMichi/elichika">elichika</a> with your web browser, click on the Code button, click on Download ZIP, save the file, and extract it. You will need to open terminal in the extracted folder with <code>main.go</code> file.</p>
<h3 id="third_step_build_the_server">Third step: Build the server<a class="headerlink" href="#third_step_build_the_server" title="Permanent link">&para;</a></h3>
<p>It's recommended to build your own server if you can, so you can stay up-to-date and make the changes necessary.</p>
<h4 id="installing_go">Installing Go<a class="headerlink" href="#installing_go" title="Permanent link">&para;</a></h4>
<p>Because the server is written in Go, you have to install it to build the server.</p>
<p>For PC platforms, you can get it <a href="https://go.dev/doc/install">here</a>.</p>
<p>For Termux, run:</p>
<pre><code>pkg install golang
</code></pre>
<h4 id="building_the_server">Building the server<a class="headerlink" href="#building_the_server" title="Permanent link">&para;</a></h4>
<p>On all platform, simply run:</p>
<pre><code>go build
</code></pre>
<p>inside the <code>elichika</code> server. You will get an <code>elichika</code> binary (<code>elichika.exe</code> on windows). Note that you will have to rebuild everytime you update or make a change.</p>
<h2 id="running_the_server">Running the server<a class="headerlink" href="#running_the_server" title="Permanent link">&para;</a></h2>
<p>Before you can play the game, you have to run the server. To do that, go to the <code>elichika</code> folder, and run the binary through terminal / command prompt:</p>
<pre><code>./elichika
</code></pre>
<p>remove the <code>./</code> on windows. On windows, you can also run it by opening the .exe file directly.</p>
<p>If you haven't configured the server correctly, you might have to change some config. Mostly you will change <code>config.json</code> or <code>main.go</code>.</p>
<p><a href="#easy-install">Easy setups</a> all have configuration ready, but you might still want to do some modifications.</p>
<p>To change the files in windows or linux GUI, you can open any text editor to change config.</p>
<p>In Termux, you should use some command-line based text editor like <code>nano</code>, or <code>vim</code>. Looks up a tutorial if you don't know how to use them. You can also just use <code>sed</code> if you are comfortable with it.</p>
<h3 id="providing_a_cdn_server">Providing a CDN server<a class="headerlink" href="#providing_a_cdn_server" title="Permanent link">&para;</a></h3>
<p>A CDN (content distribution network) server is where the game(app) will download the files necessary (i.e. songs, stories). We can set it inside <code>config.json</code>. Note that if the file is not present, just run <code>elichika</code> and close it, the file will be generated.</p>
<p>By default, it's pointed to http://192.168.1.123/static (the same address as the default <code>elichika</code> server). This essentially tell the game to download game files from http://192.168.1.123/static (from the game network environment).</p>
<p>We can change the CDN server by changing that string in the <code>config.json</code> file.</p>
<h4 id="online_cdn">Online CDN<a class="headerlink" href="#online_cdn" title="Permanent link">&para;</a></h4>
<p>Thanks to <code>sarah</code> (<code>sarayalth</code>) from the LL Hax discord, there is a CDN that we can use to avoid hosting our own files.</p>
<p>Change the cnd server to https://llsifas.catfolk.party/static, and the game will download file from that server (through the internet). This is the recommended way to do this, however the server might become unavailable later on. The <code>config.json</code> file should looks something like this:</p>
<pre><code>{&quot;app_name&quot;:&quot;elichika&quot;,&quot;settings&quot;:{&quot;cdn_server&quot;:&quot;https://llsifas.catfolk.party/static&quot;}}
</code></pre>
<p>The <a href="#easy-install">easy installs</a> all use this method.</p>
<h4 id="self_hosted_cdn">Self hosted CDN<a class="headerlink" href="#self_hosted_cdn" title="Permanent link">&para;</a></h4>
<p><code>elichika</code> has the ability to host the CDN files, but we will have to have the CDN data ready. The data is 20GB for either GL or JP server, so 40GB for both.</p>
<p>One way to get them is from <a href="https://archive.org/details/ll-sifas-cdn-data">archive.org</a>. The direct downloading speed is not that great, so be prepared to leave your machine on for a very long time. If you don't want that, download using the <code>.torrent</code>, it would be much appreciated if you also host the files once downloaded. Do note that there are risks associated with torrenting, but that topic will not be discussed here. </p>
<p>Another way to get them is from extracting the downloaded game files. You can try this once you download the necessary files (from https://llsifas.catfolk.party/static), for example. To extract the files, use <a href="https://youtu.be/j4oh3qrCrfw">this youtube tutorial</a>, or any other methods you know.</p>
<p>You can also just directly download from https://llsifas.catfolk.party/static if you have the list of necessary files (check the file database). </p>
<p>Regardless of how you get the files, you want to put them in:</p>
<pre><code>elichika/static/2d61e7b4e89961c7
</code></pre>
<p>for GL or</p>
<pre><code>elichika/static/b66ec2295e9a00aa
</code></pre>
<p>for JP. After that, edit the <code>cnd_server</code> address to be <code>http://&lt;server_address&gt;/static</code> (i.e. http://192.168.1.123/static or http://127.0.0.1:8080/static) and we're done.</p>
<h3 id="patching_the_database">Patching the database<a class="headerlink" href="#patching_the_database" title="Permanent link">&para;</a></h3>
<p>Since we use the 3.12 clients, we have to patch the database (as the cdn data was for 3.11 clients). The patched database is included in the same download with the basic clients <a href="https://mega.nz/folder/gwJizZjS#v_fSOadf9yrb_eaOze2r7Q">here</a>. Just extract the correct version GL or JP, and put them in <code>elichika/static/2d61e7b4e89961c7</code> (GL) or <code>elichika/static/b66ec2295e9a00aa</code> (JP).</p>
<p>The <a href="#easy-install">easy installs</a> have the database patch included for both JP and GL version.</p>
<p>It's possible to patch and key the database again (if you want to modify some file for example), although that is not discussed here. Join the discord and ask around for more informations.</p>
<h3 id="changing_server_port">Changing server port<a class="headerlink" href="#changing_server_port" title="Permanent link">&para;</a></h3>
<p>By default the server run on port 80. You can change by changing the <code>main.go</code> file. Remember that you have to rebuild if you do this. Maybe this is better in a config file, but it's hard coded for now.</p>
<p>To change the port, open up <code>main.go</code> the line:</p>
<pre><code>r.Run(&quot;:80&quot;)
</code></pre>
<p>to whatever port you like, i.e.:</p>
<pre><code>r.Run(&quot;:8080&quot;)
</code></pre>
<p>or </p>
<pre><code>r.Run(&quot;:1503&quot;)
</code></pre>
<p>You can also use <code>sed</code>:</p>
<pre><code>sed -i 's/r.Run(&quot;:80&quot;)/r.Run(&quot;:8080&quot;)/g' main.go
</code></pre>
<p>On some system (Linux and/or Termux), port with number less than 1024 need to have root permission (or just higher permission than normal) to open, so changing it to something bigger let you run without root. Your port 80 might also be used for other things, so you might want a new port.</p>
<h2 id="playing_the_game">Playing the game<a class="headerlink" href="#playing_the_game" title="Permanent link">&para;</a></h2>
<p>After you have the server installed and run it, just open the game. You will be prompted to choose language if you are using the GL version, English(EN), Korean (KR), and Traditional Chinese (ZH) are supported, choose the one you want.</p>
<p>You will then be prompted to download the files. If you have spaces on your phone / emulator, you can just download everything, however, other type of download also work just fine. Download everything let you play the game without the internet later on.</p>
<p>After you are done downloading, you can just play the game like normal.</p>
<p>For your information, here is the summany state of the server. Note these might be outdated, mising, or incorekt. </p>
<h3 id="stuff_that_works_at_least_partially">Stuff that works (at least partially)<a class="headerlink" href="#stuff_that_works_at_least_partially" title="Permanent link">&para;</a></h3>
<h4 id="personalization">Personalization<a class="headerlink" href="#personalization" title="Permanent link">&para;</a></h4>
<p>The following persionalizations work:
- Changing profile: You can select any card / title / name / nickname.
- Changing partner: You can select partners and their costumes, as well as the backgrounds.</p>
<h4 id="partner_interaction">Partner interaction<a class="headerlink" href="#partner_interaction" title="Permanent link">&para;</a></h4>
<p>You can interact with everyone, view their cards, view their costumes and preview them.</p>
<p>There is no bond board unlock as they are all maxed. </p>
<h4 id="3dmv">3DMV<a class="headerlink" href="#3dmv" title="Permanent link">&para;</a></h4>
<p>You can watch all the MVs, with all the settings:
- The "custom formation" tab works and you have all the outfit to choose from.
- However changing costume in the "original formation" tab doesn't work, but you can just use the "custom formation" node.</p>
<h4 id="story">Story<a class="headerlink" href="#story" title="Permanent link">&para;</a></h4>
<p>You can read ALL the stories, ALL of them:
- All main stories
- All bond stories
- All side (card) stories
- All event stories
- All Nijigasaki anime tie-in stories</p>
<h4 id="live_show">Live show<a class="headerlink" href="#live_show" title="Permanent link">&para;</a></h4>
<p>You can build team and play live shows:
- You can play all the permanent songs and story songs.
- You can play all the daily song, but they are on a rotation similar to the official game, however there is no limit to how many time you can play. Maybe it will be possible to make it so all daily song are always available.
- You have all the cards almost maxed, along with maxed bond board and bond level 500 on every character, so you can try to clear the harder songs that you didn't manage to do before the game die.
- Autoplay will also get Wonderful judgement everytime. If you didn't know, this is a server setting, so you can change the server so that it behave like the official game if you want.
- The song play record is not implemented for now, and you don't get any item drops, but the main feature is there.
- After you complete a song, you always get taken to a story menu, so it might be a bit annoying.
- Some stuff like changing formation name can crash the game, but you can just restart.
- Skip ticket doesn't work.
- Overall the core stuff is there.</p>
<h4 id="school_idols">School idols<a class="headerlink" href="#school_idols" title="Permanent link">&para;</a></h4>
<p>You have all the school idols at max level and max limit breaks.
- Most idols have their practice done, except for the party cards (will likely be fixed soon enough)
- There's no actual idol rising experience for now.</p>
<h4 id="training">Training<a class="headerlink" href="#training" title="Permanent link">&para;</a></h4>
<p>You can do training:
- Training doesn't cost any AP.
- Training doesn't give you any items.
- Training doesn't depend on the regiments, you always get the same insight awarded, so you can use that to quickly build your maxed team.
- Training doesn't give any other skill for now, so you can't build a team that has maxed out skill chance for example.</p>
<h4 id="accessories">Accessories<a class="headerlink" href="#accessories" title="Permanent link">&para;</a></h4>
<p>You have the accessories available in the original game:
- You can choose accessories for the formation just fine.
- All the DLP accessories are available and maxed.
- You also have other maxed accessories.
- But there is no way to get more for now, so you can't play into some strategy that require them.
- The game will crash if you try to disassemble or synthesize, or lock or remove from all formation etc. These will be address in due time.</p>
<h3 id="stuff_that_doesnt_work_at_least_at_the_time_of_writing">Stuff that doesn't work (at least at the time of writing)<a class="headerlink" href="#stuff_that_doesnt_work_at_least_at_the_time_of_writing" title="Permanent link">&para;</a></h3>
<p>Aside from the things that work partially, some stuff doesn't work at all and crash the game, you should avoid clicking on them.</p>
<h4 id="gacha">Gacha<a class="headerlink" href="#gacha" title="Permanent link">&para;</a></h4>
<p>Sadly you can't gacha for now.</p>
<h4 id="membership_card">Membership card<a class="headerlink" href="#membership_card" title="Permanent link">&para;</a></h4>
<p>Membership doesn't work on the global version (tapping it results in a crash).</p>
<p>Supposedly it works in the JP version.</p>
<h4 id="news">News<a class="headerlink" href="#news" title="Permanent link">&para;</a></h4>
<p>The news menu works but it shows you JP news, and if you click on the news it crashes.</p>
<h4 id="goals">Goals<a class="headerlink" href="#goals" title="Permanent link">&para;</a></h4>
<p>There's no goal (mission), you can click on it but it will freeze your game, so you will need to restart the game.</p>
<h4 id="channel_member">Channel member<a class="headerlink" href="#channel_member" title="Permanent link">&para;</a></h4>
<p>Crash the game if clicked on.</p>
<h4 id="shop_and_exchange">Shop and exchange<a class="headerlink" href="#shop_and_exchange" title="Permanent link">&para;</a></h4>
<p>Crash the game if clicked on.</p>
<h4 id="multiplayer">Multiplayer<a class="headerlink" href="#multiplayer" title="Permanent link">&para;</a></h4>
<p>No form of multiplayer exist or can exist with the current implementation. That might change later on.</p>
<h4 id="event_sbl_and_dlp">Event, SBL, and DLP<a class="headerlink" href="#event_sbl_and_dlp" title="Permanent link">&para;</a></h4>
<p>There is currently no way to play these modes. In the future, someone might figure that out.</p>
<h2 id="future_of_the_server">Future of the server<a class="headerlink" href="#future_of_the_server" title="Permanent link">&para;</a></h2>
<p>Development is still being done on the server by YumeMichi. If you want to help, joining the LL Hax discord would be a good first step.</p>
<p>Ideally, we would at least have a server that offer the same experience of the SIFAS journey: Getting cards, costumes, clearing goals, raising idols, raising bond level and so on.</p>
<h2 id="easy_install">Easy install<a class="headerlink" href="#easy_install" title="Permanent link">&para;</a></h2>
<p>This section provide some prebuilt server binaries and some clients so you don't have to make the modifications yourself.</p>
<h3 id="clients">Clients<a class="headerlink" href="#clients" title="Permanent link">&para;</a></h3>
<ul>
<li><a href="https://github.com/YumeMichi/elichika">elichika</a> provided <a href="https://mega.nz/folder/gwJizZjS#v_fSOadf9yrb_eaOze2r7Q">android and ios clients</a>. Connect to server at http://192.168.1.123:80</li>
<li>localhost android clients. Connect to server at http://127.0.0.1:8080</li>
<li>LAN android clients. Connect to server at http://192.168.1.123:8080</li>
<li>For the <code>.apk</code> clients, you can get them <a href="https://codeberg.org/arina999999997/nozomi/releases">here</a>. The naming format is <code>ALL_STARS_3.12.0_version_ip_ip_ip_ip_port</code>. Version being GL or JP.</li>
</ul>
<h3 id="servers">Servers<a class="headerlink" href="#servers" title="Permanent link">&para;</a></h3>
<ul>
<li><a href="https://github.com/YumeMichi/elichika">elichika</a> server source.</li>
<li><a href="https://github.com/YumeMichi/elichika">elichika</a> server resource: download directly from <a href="https://github.com/YumeMichi/elichika/archive/refs/heads/master.zip">github</a> and unzip.</li>
<li><a href="https://codeberg.org/arina999999997/nozomi/raw/branch/master/catfolk_cdn.json">catfolk CDN patch</a>.</li>
<li>static/database: <a href="https://mega.nz/folder/gwJizZjS#v_fSOadf9yrb_eaOze2r7Q">same download as elichika provided clients</a>, or <a href="https://codeberg.org/arina999999997/nozomi_static_db/archive/master.zip">direct zip</a></li>
<li><a href="https://github.com/YumeMichi/elichika">elichika</a> prebuilt <a href="https://codeberg.org/arina999999997/nozomi/releases">server binaries</a> for various OS and architectures so you don't or can't install go. The file names is in the format: <code>elichika_&lt;OS&gt;_&lt;ARCH&gt;_&lt;PORT&gt;</code>.</li>
<li>To use a server version, download the server resource and extract it, download the CDN patch, download the correct binary. Put the binary and CDN patch inside the extracted server resource and run the binary.</li>
</ul>
<h3 id="common_setups">Common setups<a class="headerlink" href="#common_setups" title="Permanent link">&para;</a></h3>
<h4 id="server_and_client_run_on_android_with_termux">Server and client run on Android, with Termux<a class="headerlink" href="#server_and_client_run_on_android_with_termux" title="Permanent link">&para;</a></h4>
<p>The server run inside Termux, on the same phone or emulator that you want to play SIFAS on. After downloading all of the game files, you can play anywhere anytime even without internet.</p>
<ul>
<li>Download the client that point to http://127.0.0.1:8080 and install it in your phone.<ul>
<li><a href="https://codeberg.org/attachments/8d11c7d9-a57d-498e-ba3e-4fe529e741a6">GL version</a></li>
<li><a href="https://codeberg.org/attachments/0483f301-b0cd-4cc5-b1a6-74da15419a90">JP version</a></li>
</ul>
</li>
<li>Open up termux and enter the follow commands:</li>
</ul>
<pre><code>curl https://codeberg.org/arina999999997/nozomi/raw/branch/master/termux_install_script.sh -o sifas_install.sh &amp;&amp; bash sifas_install.sh
</code></pre>
<ul>
<li>After that run the <code>elichika</code> server:</li>
</ul>
<pre><code>cd elichika
./elichika
</code></pre>
<ul>
<li>Finally run the game and enjoy.</li>
</ul>
<p>If that doesn't work, you might have one of the following problems:
- If you can't install the <code>.apk</code> then you're out of luck, either play with a 64 bits emulator or phone.
- If anything happen before you run the binary, your Termux has problem. Install through this <a href="#installing-termux-for-android">guide</a>.
- If you run the server binary and it doesn't work, it's likely that your system has a different architecture. It might also start and give you a warning (this still works). The way to resolve this is to install golang and build the server yourself:</p>
<pre><code>apt install golang
go build
</code></pre>
<ul>
<li>Note that in some system, even if you can build the go binary, you will still have a problem when running it. If this happens, it's easier to just use another device that work.</li>
</ul>
<h4 id="server_on_pc_play_on_phone_through_wi-fi">Server on PC, play on phone, through Wi-Fi<a class="headerlink" href="#server_on_pc_play_on_phone_through_wi-fi" title="Permanent link">&para;</a></h4>
<p>The server run on your PC (Windows / Linux / MacOS). You play on your phone. The 2 devices has to be in the same network.</p>
<ul>
<li>Download the client that point to http://192.168.1.123:80 (or http://192.168.1.123:8080 if you can't use port 80) and install that.</li>
<li>Download the server (your architecture + port). If the architecture is not in the release, then you will have to build your own with go.</li>
<li>Change your PC's local IP to 192.168.1.123. You might also have to deal with firewall stuff. Look up how to change IP on <code>&lt;your specific system&gt;</code> if you have trouble.</li>
<li>Run the binary on PC and run the game on your phone.</li>
<li>Note that if you are using port 80, you might need to run the server with root permission on Linux and MacOS, otherwise the program just close after it start.</li>
</ul>
<h4 id="server_on_pc_play_on_android_phone_through_adb">Server on PC, play on android phone, through adb<a class="headerlink" href="#server_on_pc_play_on_android_phone_through_adb" title="Permanent link">&para;</a></h4>
<p>In the case that you want to run server on PC but play on android phone, and you can't get the IP/port, you can rely on <a href="https://developer.android.com/tools/adb">adb</a>.</p>
<ul>
<li>Download the client that point to http://127.0.0.1:8080 and install it in your phone.</li>
<li>Download a server that run at http://127.0.0.1:8080 on your PC.</li>
<li>Enable <a href="https://developer.android.com/studio/debug/dev-options">developer options</a>, and turn on <code>adb</code>.</li>
<li>Connect your phone to your pc, accept the USB debugging and run:</li>
</ul>
<pre><code>adb reverse tcp:8080 tcp:8080
</code></pre>
<ul>
<li>This map http://127.0.0.1:8080 in your phone to http://127.0.0.1:8080 in your PC, allow the app to connect to the server.</li>
<li>If you don't want to have your phone plugged in to your computer, debug the phone through <code>tcpip</code> mode. If you are going to do this, it's good to have a static IP for your phone, then you can make a script that connect to your phone and run the server,for convinience. </li>
</ul>
<h4 id="server_on_pc_play_on_android_emulator">Server on PC, play on android emulator<a class="headerlink" href="#server_on_pc_play_on_android_emulator" title="Permanent link">&para;</a></h4>
<p>If you want to play on an emulator and don't want to use Termux, you can use either <code>adb</code>, or you can bridge the network so your emulator get treated as a device in your LAN. The details on how to do this depend on the emulator, so you should look it up yourself.</p>
<h2 id="random_knowledge">Random knowledge<a class="headerlink" href="#random_knowledge" title="Permanent link">&para;</a></h2>
<p>Some random knowledge that you might already know, or stuff that is inconvenience to discuss elsewhere.</p>
<h3 id="install_necessary_program_in_linuxmactermux">Install necessary program in Linux/Mac/Termux<a class="headerlink" href="#install_necessary_program_in_linuxmactermux" title="Permanent link">&para;</a></h3>
<p>If you need a program, say <code>git</code>, you can just type it to the terminal. The terminal will say that you don't have that program, but it will let you know which command to install the thing. If it doesn't then the tool you are trying to use is very niche, but you can still find some installing guide by searching.</p>
<h3 id="installing_apk">Installing .apk<a class="headerlink" href="#installing_apk" title="Permanent link">&para;</a></h3>
<p>For android, you can just use your phone/emulator to download the <code>.apk</code> and install it. You might have to go through some step / permission, but it should be doable.</p>
<p>Pretty much all emulators have a way to install <code>.apk</code>. You can use that feature for them. Most of them also let you install <code>.apk</code> by dragging them into the emulator.</p>
<p>Finally, you can install <code>.apk</code> through <code>adb</code>.</p>
<h3 id="installing_ipa">Installing .ipa<a class="headerlink" href="#installing_ipa" title="Permanent link">&para;</a></h3>
<p>For ios, it's way harder to install custom package. Please look up guide or ask the communities for help.</p>
<h3 id="installing_termux_for_android">Installing termux (for android)<a class="headerlink" href="#installing_termux_for_android" title="Permanent link">&para;</a></h3>
<p><a href="https://termux.dev/en/">Termux</a> give you access to various things, you can do things usually done on computers like programming. In our case, it let us run the server and play the game everywhere (without internet if you has downloaded the game files).</p>
<p>You can build termux yourself, but for simplicity, you can install Termux through the <a href="https://f-droid.org/en/packages/com.termux/">F-Droid release</a>. You can either use the F-Droid app, or download the <code>.apk</code> directly from the page and install that.</p>
<p>Note that the Termux from Google Play store is very OUTDATED, and it will likely NOT WORK. </p>
</article>
</div>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "..", "features": [], "search": "../assets/javascripts/workers/search.74e28a9f.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../assets/javascripts/bundle.220ee61c.min.js"></script>
</body>
</html>
Reference in a new issue View git blame Copy permalink