Discord Client Modding Wiki - User contributions [en]

V126.21

2025-09-20T19:45:03Z

Rushii: fix wording

v126.21 is a reference to the version number 126021, the last stable release of the Discord Android app to be built upon Kotlin and utilize Android views for UI. It was released sometime in the summer of 2022. This version is unofficially referred to by Aliucord developers as any of the following: "discordkt", "126021", "126.21", "KNA" (Kotlin Native App), or "kotler".

The next stable release of the Discord Android app (RNA) was new rewrite of the app, based on the [https://reactnative.dev/ React Native] framework. The change of frameworks and languages made all existing client mods for Android completely incompatible, such as [[Aliucord]], Treecord, and CutTheCord. This rewrite for Android "unified" the codebase and UX across iOS and Android, providing a consistent experience between the platforms.

However, the rushed released of this rewrite led to tons of bugs, lag, and layout issues. The performance of the rewrite was so atrocious that even flagship phones ($1000USD+) were unable to smoothly render the app, despite the older, ''actually'' native app working completely fine.

In late 2021, prior to the official release of the RNA (React Native Android) rewrite, Aliucord developers were able to obtain canary builds of the main HBC (Hermes bytecode) bundle, containing the main portion of the app. Some efforts led to a partial re-implementation of the missing native portion, and led to a working preview of the unreleased rewrite. This also served as a testing ground to develop a new client mod, "AliucordRN", targeting the RNA app. However, even 7 months after the official RNA release, efforts to develop AliucordRN dwindled due to the increase in difficulty compared to modding the old app. This was compounded by the unwillingness to actually use RNA, from the inferior UX it provided. Eventually, all efforts were abandoned. However, one of the original contributors to AliucordRN, [Zoey](https://github.com/NotZoeyDev), continued their efforts in a separate project aimed at creating a Discord client mod iOS: [https://github.com/enmity-mod Enmity].
[[Category:Lore]]

Pomelo massban incident

2025-08-22T15:56:01Z

Rushii: fix wording

== Incident ==
On Tuesday, 9 May 2023, several Discord users were simultaneously banned. Users who were banned lost access to their accounts and were unable to log back in. Shortly after the incident, a [https://www.reddit.com/r/discordapp/comments/13d01h7/anyone_elses_account_randomly_disabled/ Reddit post] was created on the r/discord subreddit. Discord staff u/coral-discord informed people that they were investigating the situation and asked affected users for their usernames. Within hours, the issue was resolved, and affected users were able to log back into their accounts after resetting their passwords.

== Reason ==
Although the real reason is not known, community members theorized that it was related to Discord's new usernames (Pomelo). This change removed discriminators from usernames, making all usernames globally unique. As the feature was slowly being rolled out, some users wanted to check if their usernames had been taken. To do this, they made an HTTP request to the Discord Pomelo endpoint. However, they likely failed to add all the necessary HTTP headers for that endpoint, which would've triggered antispam and flagged their account for suspicious behavior.

[[Category:Drama & Incidents]]

V126.21

2025-06-13T07:36:49Z

Rushii: more lore

v126.21 is a reference to the version number 126021, the last stable release of the Discord Android app to be built upon Kotlin and utilize Android views for UI. It was released sometime in the summer of 2022. This version is unofficially referred to by Aliucord developers as any of the following: "discordkt", "126021", "126.21", "KNA" (Kotlin Native App), or "kotler".

The next stable release of the Discord Android app (RNA) was new rewrite of the app, based on the [https://reactnative.dev/ React Native] framework. The change of frameworks and languages made all existing client mods for Android completely incompatible, such as [[Aliucord]], Treecord, and CutTheCord. This rewrite for Android "unified" the codebase and UX across iOS and Android, providing a consistent experience between the platforms.

However, the rushed released of this rewrite led to tons of bugs, lag, and layout issues. The performance of the rewrite was so atrocious that even flagship phones ($1000USD+) were unable to smoothly render the app, despite the older, ''actually'' native app working completely fine.

In December 2022, prior to the official release of the RNA (React Native Android) rewrite, Aliucord developers were able to obtain a rolling canary release of the main HBC (Hermes bytecode) bundle, containing the main portion of the app. Some efforts led to a partial re-implementation of the missing native portion, and gave a preview into the unreleased version. This also served as a testing ground to develop a new client mod, "AliucordRN", targeting the RNA app.

Even after the official RNA release 7 months later, efforts to develop AliucordRN slowly dwindled due to the large increase in difficulty compared to modding the old app, compounded by the unwillingness to actually use RNA, from the inferior UX it provided. Eventually, all efforts were abandoned. However, AliucordRN served as the predecessor of [https://github.com/enmity-mod Enmity], a Discord client mod for iOS.

[[Category:Lore]]

Aliucord

2025-06-13T07:09:59Z

Rushii:

__NOTOC__
{{Infobox mod
| name = Aliucord
| logo = Aliucord logo.png
| logoCaption = The original Aliucord logo, author unknown.
| yearsActive = February 2021 - present
| platforms = Android
| developers = [[Juby210]], [[User:Rushii]], [[User:Vendicated]]
| licenses = OSL-3.0
| repo = [https://github.com/Aliucord/Aliucord Aliucord/Aliucord]
| languages = [[wikipedia:Kotlin_(programming_language)|Kotlin]], [[wikipedia:Java_(programming_language)|Java]]
}}
'''Aliucord''', commonly referred to as '''Aliu''' or '''AC''', is a mobile Discord client mod for Android. It is based on the [[v126.21]] version of the Android app, a version from mid-2022 now called the ''Legacy Android App''<ref>{{cite web|title=Discord incident status referencing the legacy app|url=https://discordstatus.com/incidents/pp6njm8bcwzq}}</ref>. Its primary patching method is runtime ART hooking using [[LSPlant]].

==Backstory==
TODO

==Architecture==
While Aliucord is an extremely complex project (actively used source code is spread across ''at least'' 13 repositories), the main components can be simplified down to just four. ''Installer'' (alternatively [[#Manager|''Manager'']]), ''Injector'', ''Core'', and the external plugins. The ''Installer'' is a separate app that handles downloading the Discord APK from a mirror, adding in a precompiled ''Injector'', which replaces an entry point into the app. Once this replaced class is run, the ''Injector'' initializes LSPlant and downloads a precompiled ''Core'' to execute, which applies some fixes and then loads externally installed plugins.

More detailed info can be found in this blog post: {{cite web|title=Aliucord: Modding the legacy Discord app|url=https://rushii.materii.dev/aliucord}}

==Manager==
''Aliucord Manager'' was created in the summer of 2021<ref>{{cite web|title=Aliucord Manager initial commit|url=https://github.com/Aliucord/Manager/commit/7881279196652bf79ae83d971689d6ea6731d833}}</ref>, aiming to replace the Aliucord Installer with better design. It is written entirely in [[wikipedia:Kotlin_(programming_language)|Kotlin]] and [https://developer.android.com/jetpack/compose Jetpack Compose]. As of March 2024, it is still under development, nearly three years later. While initially, the main idea of this rewrite was to stop using [[wikipedia:Flutter_(software)|Flutter]], new ideas and features started to be implemented, aided by collaboration with [[Vendetta]]'s [https://github.com/vendetta-mod/VendettaManager Manager]. A more user-friendly UI, an install flow that handles edge cases, and multi-install support are some of the main differences.


==Notes==
<references/>

[[Category:Client Mods]]

Aliucord

2025-06-13T07:09:12Z

Rushii:

__NOTOC__
{{Infobox mod
| name = Aliucord
| logo = Aliucord logo.png
| logoCaption = The original Aliucord logo, author unknown.
| yearsActive = February 2021 - present
| platforms = Android
| developers = [[Juby210]], [[User:Rushii]], [[User:Vendicated]]
| licenses = OSL-3.0
| repo = [https://github.com/Aliucord/Aliucord Aliucord/Aliucord]
| languages = [[wikipedia:Kotlin_(programming_language)|Kotlin]], [[wikipedia:Java_(programming_language)|Java]]
}}
'''Aliucord''', commonly referred to as '''Aliu''' or '''AC''', is a mobile Discord client mod for Android. It is based on the [v126.21]] version of the Android app, a version from mid-2022 now called the ''Legacy Android App''<ref>{{cite web|title=Discord incident status referencing the legacy app|url=https://discordstatus.com/incidents/pp6njm8bcwzq}}</ref>. Its primary patching method is runtime ART hooking using [[LSPlant]].

==Backstory==
TODO

==Architecture==
While Aliucord is an extremely complex project (actively used source code is spread across ''at least'' 13 repositories), the main components can be simplified down to just four. ''Installer'' (alternatively [[#Manager|''Manager'']]), ''Injector'', ''Core'', and the external plugins. The ''Installer'' is a separate app that handles downloading the Discord APK from a mirror, adding in a precompiled ''Injector'', which replaces an entry point into the app. Once this replaced class is run, the ''Injector'' initializes LSPlant and downloads a precompiled ''Core'' to execute, which applies some fixes and then loads externally installed plugins.

More detailed info can be found in this blog post: {{cite web|title=Aliucord: Modding the legacy Discord app|url=https://rushii.materii.dev/aliucord}}

==Manager==
''Aliucord Manager'' was created in the summer of 2021<ref>{{cite web|title=Aliucord Manager initial commit|url=https://github.com/Aliucord/Manager/commit/7881279196652bf79ae83d971689d6ea6731d833}}</ref>, aiming to replace the Aliucord Installer with better design. It is written entirely in [[wikipedia:Kotlin_(programming_language)|Kotlin]] and [https://developer.android.com/jetpack/compose Jetpack Compose]. As of March 2024, it is still under development, nearly three years later. While initially, the main idea of this rewrite was to stop using [[wikipedia:Flutter_(software)|Flutter]], new ideas and features started to be implemented, aided by collaboration with [[Vendetta]]'s [https://github.com/vendetta-mod/VendettaManager Manager]. A more user-friendly UI, an install flow that handles edge cases, and multi-install support are some of the main differences.


==Notes==
<references/>

[[Category:Client Mods]]

MessageLogger

2024-06-25T18:10:32Z

Rushii: /* Controversy */typo

Message Loggers are plugins that allow users to view deleted & edited Discord messages.

== Features ==
[[File:Message_Logger_preview_deleted_messages.png|alt=This is how deleted messages look like|thumb|This is how deleted messages look like]][[File:Message_Logger_Preview_Edited_Messages.png|alt=This is how Edited Messages looks like|thumb|This is how edited messages look like]]

Message loggers allow users to see:
* Recently deleted messages. A red text indicates the deleted messages.
* Recently edited messages. A gray text indicates the edited message.

== Versions (selection) ==

* [https://1lighty.github.io/BetterDiscordStuff/?plugin=MessageLoggerV2 MessageLoggerV2], a [[BetterDiscord]] plugin by [[Lighty]]
* [https://github.com/Juby210/Aliucord-plugins MessageLogger], an [[Aliucord]] plugin by [[Juby]]
* [https://vencord.dev/plugins/MessageLogger MessageLogger], a [[Vencord]] plugin by [[rushii]]

== Controversy ==
Use of MessageLoggers is very controversial in the community, with multiple [[client mods]] such as [[BetterDiscord]]<ref name="bd-faq">{{Cite web|url=https://betterdiscord.app/FAQ|quote=Message loggers are in violation discord's API terms and privacy policy, and can result in account termination. We will not provide such plugins|title=BetterDiscord FAQ point 11}}</ref> and [[Powercord]]<ref>{{Cite web|url=https://powercord.dev/guidelines|archive-url=https://web.archive.org/web/20210314211818/https://powercord.dev/guidelines|archive-date=2021-03-14|quote=End User Data of other users must be handled with caution with regards to privacy. For example, logging all deleted messages is prohibited.|title=Powercord Guidelines point 2}}</ref> prohibiting their usage outright and theme developers who vehemently oppose them have [https://github.com/NYRI4/LilyPichu/commit/49b169d1436c9de9b238f09c1fb72e00418f8141 attempted] to block users of it in the past, only to later revert their changes.

Common reasons are that they "violate user privacy" and "Discord's privacy policy and API terms," with multiple sources claiming that using loggers poses a risk to your account.<ref name="bd-faq" />

While the morality of their usage is debatable, claims that message loggers are dangerous are nothing more than blatant disinformation. As all the functionality provided by these plugins is performed client-side, ''without interacting with the API or gateway'', it is impossible for these plugins to pose a risk by simply using them.

Furthermore, there have been no documented cases of users getting their accounts banned just for even revealing they use message loggers. As a result, such plugins still see wide usage across practically all client mods, even on those that officially prohibit them.

Additionally, Discord's Developer terms of service only apply to "access to and use of the [Discord] APIs"<ref>{{Cite web|url=https://discord.com/developers/docs/policies-and-agreements/developer-terms-of-service|title=Discord Developer Terms of Service}}</ref>. Since logger plugins entirely rely on data the client ''already has'', these terms can't be applied to them.

The only applicable term from the terms of service is the disallowance of modifying Discord services, which [[client mods]] themselves break. As this is not unique to message loggers, using this term to single out message loggers explicitly is inappropriate as well.

== Citations ==
<references />

[[Category:Plugins]]

MessageLogger

2024-03-28T08:11:40Z

Rushii: Elaborate on claims about danger of message loggers

Message Loggers are plugins that allow users to view deleted & edited Discord messages.

== Features ==
[[File:Message_Logger_preview_deleted_messages.png|alt=This is how deleted messages look like|thumb|This is how deleted messages look like]]

Message loggers allow users to see:
* Recently deleted messages. A red text indicates the deleted messages.
* Recently edited messages. A gray text indicates the edited message.

== Versions (selection) ==

* [https://1lighty.github.io/BetterDiscordStuff/?plugin=MessageLoggerV2 MessageLoggerV2], a [[BetterDiscord]] plugin by [[Lighty]]
* [https://github.com/Juby210/Aliucord-plugins MessageLogger], an [[Aliucord]] plugin by [[Juby]]
* [https://vencord.dev/plugins/MessageLogger MessageLogger], a [[Vencord]] plugin by [[rushii]]

== Controversy ==
[[File:Message_Logger_Preview_Edited_Messages.png|alt=This is how Edited Messages looks like|thumb|This is how Edited Messages lo]]

Use of MessageLoggers is very controversial in the community, with multiple [[client mods]] such as [[BetterDiscord]]<ref name="bd-faq">{{Cite web|url=https://betterdiscord.app/FAQ|quote=Message loggers are in violation discord's API terms and privacy policy, and can result in account termination. We will not provide such plugins|title=BetterDiscord FAQ point 11}}</ref> and [[Powercord]]<ref>{{Cite web|url=https://powercord.dev/guidelines|archive-url=https://web.archive.org/web/20210314211818/https://powercord.dev/guidelines|archive-date=2021-03-14|quote=End User Data of other users must be handled with caution with regards to privacy. For example, logging all deleted messages is prohibited.|title=Powercord Guidelines point 2}}</ref> prohibiting their usage outright and theme developers who vehemently oppose them have [https://github.com/NYRI4/LilyPichu/commit/49b169d1436c9de9b238f09c1fb72e00418f8141 attempted] to block users of it in the past, only to later revert their changes.

Commonly stated reasons are that they "violate user privacy" and "Discord's privacy policy and API terms", with multiple sources claiming usage of loggers poses a risk to your account.<ref name="bd-faq" />

While the morality of their usage is debatable, claims that message loggers are dangerous is nothing more than blatant disinformation. As all the functionality provided by these plugins is performed client-side, ''without interacting with the API or gateway'', it is simply impossible for these plugins to pose a risk by simply using them.

Furthermore, there have been no documented cases of users getting account banned for just for even revealing they use message loggers. As a result, such plugins still see wide usage across practically all client mods, even on those that officially prohibit them.

Additionally, Discord's Developer terms of service only apply to "access to and use of the [Discord] APIs"<ref>{{Cite web|url=https://discord.com/developers/docs/policies-and-agreements/developer-terms-of-service|title=Discord Developer Terms of Service}}</ref>. Since logger plugins entirely rely on data the client ''already has'', these terms can't really be applied to them.

The only applicable term from the terms of service would be the disallowing of modifying Discord services, which [[client mods]] themselves break. As this is not unique to message loggers, using this term to specifically single out message loggers is inappropriate as well.

== Citations ==
<references />

[[Category:Plugins]]

Aliucord

2024-03-09T01:22:29Z

Rushii: add some basic info

__NOTOC__
{{Infobox
| name = Aliucord
| above = Aliucord

| image = [[File:Aliucord logo.png|thumb]]
| caption1 = The original Aliucord logo, author unknown.<p><br/></p>

| label1 = Status
| data1 = Active

| label3 = Repository
| data3 = [https://github.com/Aliucord/Aliucord Aliucord/Aliucord]

| label4 = Language
| data4 = [[wikipedia:Kotlin_(programming_language)|Kotlin]] + [[wikipedia:Java_(programming_language)|Java]]

| label5 = License
| data5 = OSL-3.0
}}

''Aliucord'', commonly referred to as ''Aliu'', or ''AC'', is a mobile Discord client mod for Android. It targets the [[v126.21]] version of the Android app, a version from mid-2022 now called the ''Legacy Android App''<ref>{{cite web|title=Discord incident status referencing the legacy app|url=https://discordstatus.com/incidents/pp6njm8bcwzq}}</ref>. It's primary method of patching is runtime ART hooking through the use of [[LSPlant]].

==Backstory==
TODO

==Architecture==
While Aliucord is an extremely complex project (actively used source code is spread across ''at least'' 13 repositories), the main components can be simplified down to just four. ''Installer'' (alternatively [[#Manager|''Manager'']]), ''Injector'', ''Core'', and the external plugins. The ''Installer'' is a separate app that handles downloading the Discord APK from a mirror, adding in a precompiled ''Injector'', which replaces an entry point into the app. Once this replaced class is run, the ''Injector'' initializes LSPlant and downloads a precompiled ''Core'' to execute, which applies some fixes and then loads externally installed plugins.

More detailed info can be found in this blog post: {{cite web|title=Aliucord: Modding the legacy Discord app|url=https://rushii.materii.dev/aliucord}}

==Manager==
''Aliucord Manager'' was created in the summer of 2021<ref>{{cite web|title=Aliucord Manager initial commit|url=https://github.com/Aliucord/Manager/commit/7881279196652bf79ae83d971689d6ea6731d833}}</ref>, aiming to replace the Aliucord Installer with better design. It is written entirely in [[wikipedia:Kotlin_(programming_language)|Kotlin]] and [https://developer.android.com/jetpack/compose Jetpack Compose]. As of March 2024, nearly 3 years later, it is still under development. While initially the main idea of this rewrite was to stop using [[wikipedia:Flutter_(software)|Flutter]], new ideas and features started to be implemented, aided by collaboration with [[Vendetta]]'s [https://github.com/vendetta-mod/VendettaManager Manager]. A more user-friendly UI, an install flow that handles edge cases, and multi-install support are some of the main differences.


==Notes==
<references/>

[[Category:Client Mods]]

Aliucord

2024-03-08T23:12:47Z

Rushii: improve infobox

{{Infobox
| name = Aliucord
| above = Aliucord

| image = [[File:Aliucord logo.png|thumb]]
| caption1 = The original Aliucord logo, author unknown.<p><br/></p>

| label1 = Status
| data1 = Active

| label3 = Repository
| data3 = [https://github.com/Aliucord/Aliucord Aliucord/Aliucord]

| label4 = Language
| data4 = [[wikipedia:Kotlin_(programming_language)|Kotlin]] + [[wikipedia:Java_(programming_language)|Java]]

| label5 = License
| data5 = OSL-3.0
}}

''Aliucord'', commonly referred to as ''Aliu'' or ''AC'', is a mobile Discord client mod for Android. It targets the [[v126.21]] version of the Android Discord app, now referred to as the legacy mobile app.

==Notes==
<references/>

[[Category:Client Mods]]

Opencord

2024-03-08T21:31:34Z

Rushii: use infobox

{{Infobox
| name = Opencord
| above = Opencord

| image = [[File:Opencord.png|thumb]]
| caption1 = The original Opencord logo, designed by Wing.<p><br/></p>

| label1 = Status
| data1 = Discontinued

| label2 = Authors
| data2 = [https://github.com/X1nto Xinto], [https://github.com/rushiiMachine rushii]

| label3 = Repository
| data3 = [https://github.com/MateriiApps/OpenCord MateriiApps/OpenCord]

| label4 = Language
| data4 = [[wikipedia:Kotlin_(programming_language)|Kotlin]] + [https://developer.android.com/jetpack/compose Jetpack Compose]

| label5 = License
| data5 = GPLv3
}}

[https://github.com/MateriiApps/OpenCord Opencord] was an open-source Material You implementation of the Discord Android app. Created in late August of 2021, it has reimplemented a sizable portion of the mobile Discord client, completely from scratch. Despite steady development initially, it alternated between periods of rapid progress and months of inactivity. Progress completely stopped by May 2023, and it was archived on Jan 12, 2024. As of March 2024, it still has over 1.2k stars on GitHub.

==Backstory==

While the original reason for its creation was that Xinto was fed up with crossplatform React Native apps everywhere<ref>{{cite web|title=Materii discord message|url=https://discord.com/channels/885879572447522817/885879572447522820/1215711663525863442}}</ref>, as [[Aliucord]], another client mod, started to mature, it became apparent that adding dozens of fixes onto an outdated client would eventually become unsustainable, and an entirely new client would be needed. While the first 8 months of development were only propelled by [https://github.com/x1nto Xinto], in Apr 2022, [https://github.com/rushiiMachine rushii] started contributing to the project and eventually became one of the two main developers. After an amount of time, most contributions started to be done by only rushii as Xinto focused on other projects. Eventually, rushii stopped work on it as well due to roadblocks in designing a proper architecture, exacerbated by loads of technical debt, and dozens of heated debates over the most minuscule of changes.

One of the main goals of the project was to avoid the instability of client mods by reimplementing everything from scratch, instead of relying on patching Discord code which can easily break due to updates. In doing so, a lot of things could be omitted or simplified, like the intentional exclusion of nitro features. (i.e. super reactions, profile effects, etc.) Having a clean interface that focused on usability and simplicity while remaining functional was an important design goal.

While Discord doesn't "care" about client mods or 3rd party clients, the truth is that if certain API and gateway requests are incorrect, the account will be flagged in a variety of ways and could cause additional captchas, forcing phone verification, or an outright ban.<ref>{{cite web|title=Cordless shutdown notice|url=https://github.com/Bios-Marcel/cordless?tab=readme-ov-file#i-am-closing-down-the-cordless-project}}</ref> This is one of the major reasons why development took so long since the client must act exactly like a [[v126.21]] Discord client, from the identification sent to the API and gateway, to adhering to all ratelimits, to even spoofing the TLS metadata.<ref>{{cite web|title=JA3 TLS fingerprinting|url=https://github.com/salesforce/ja3}}</ref>

==Architecture==

Opencord is written in [[wikipedia:Kotlin_(programming_language)|Kotlin]] with the use of [https://developer.android.com/jetpack/compose Jetpack Compose], a modern declarative native UI framework for Android. Most of the codebase is based on dependency injection with [https://insert-koin.io Koin], in such a way that it would be theoretically testable in the future. While basic gateway functionality lives independently, most of the complex logic, including caching and live state, lives in [https://github.com/MateriiApps/OpenCord/tree/4e9ed5e92a2879e4e1ccc7aea9b53499e3110f6f/app/src/main/java/com/xinto/opencord/store Stores], a concept taken from the original Discord codebase.

While most of the UI is broken up into small <code>@Composable</code> components, complex UI was wrongly implemented, leading to dozens of recomposition issues that took an insane amount of effort to fix. Additionally, due to the idiomaticity of Compose, complex UI components can be split up into the layout and content, where invoking the layout forces you to provide all the content to the layout. This led to a lot of repetitiveness throughout the codebase, quickly becoming [https://github.com/MateriiApps/OpenCord/blob/4e9ed5e92a2879e4e1ccc7aea9b53499e3110f6f/app/src/main/java/com/xinto/opencord/ui/screens/home/panels/chat/ChatLoaded.kt#L80-L285 unmaintainable]. While this was eventually planned to be refactored out, that never happened. This has been taken into consideration regarding future projects of the developers and it hasn't happened to this extent since.

==Notes==
<references/>

[[Category:Custom Clients]]

DeadSystemException

2024-03-08T21:16:04Z

Rushii: small cleanup

An [https://developer.android.com/reference/android/os/DeadSystemException Android error] that is thrown when the system dies.

This error can be sometimes be unexpectedly thrown on certain devices if using Aliucord's [https://github.com/rushiiMachine/aliucord-plugins/tree/master/AudioPlayer AudioPlayer] plugin.
Nobody knows how or why AudioPlayer is causing that error, because the system crashes into recovery afterwards<ref>{{cite web|title=Aliucord Discord message (Ven)|url=https://discord.com/channels/811255666990907402/811261478875299840/924777944671461417}}</ref> and the logs are only accessible with root.<ref>{{cite web|title=Aliucord Discord message (HaramKing)|url=https://discord.com/channels/811255666990907402/811261478875299840/924418278225485845}}</ref>

A sample DeadSystemException:
{{codesample|lang=java|
java.lang.RuntimeException: android.os.DeadSystemException
at android.view.ViewRootImpl.systemGestureExclusionChanged(ViewRootImpl.java:4671)
at android.view.ViewRootImpl$ViewRootHandler.handleMessage(ViewRootImpl.java:5582)
at android.os.Handler.dispatchMessage(Handler.java:106)
at android.os.Looper.loop(Looper.java:233)
at android.app.ActivityThread.main(ActivityThread.java:8035)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:631)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:978)
Caused by: android.os.DeadSystemException
... 8 more
}}

==Notes==
<references/>

Opencord

2024-03-08T17:33:31Z

Rushii: add input from xinto and cleanup

[[File:Opencord.png|thumb|Opencord's original logo]]

[https://github.com/MateriiApps/OpenCord Opencord] was an open-source Material You implementation of the Discord Android app. Created in late August of 2021, it has reimplemented a sizable portion of the mobile Discord client, completely from scratch. Despite steady development initially, it alternated between periods of rapid progress and months of inactivity. Progress completely stopped by May 2023, and it was archived on Jan 12, 2024. As of March 2024, it still has over 1.2k stars on GitHub.

==Backstory==

While the original reason for its creation was that Xinto was fed up with crossplatform React Native apps everywhere<ref>{{cite web|title=Materii discord message|url=https://discord.com/channels/885879572447522817/885879572447522820/1215711663525863442}}</ref>, as [[Aliucord]], another client mod, started to mature, it became apparent that adding dozens of fixes onto an outdated client would eventually become unsustainable, and an entirely new client would be needed. While the first 8 months of development were only propelled by [https://github.com/x1nto Xinto], in Apr 2022, [https://github.com/rushiiMachine rushii] started contributing to the project and eventually became one of the two main developers. After an amount of time, most contributions started to be done by only rushii as Xinto focused on other projects. Eventually, rushii stopped work on it as well due to roadblocks in designing a proper architecture, exacerbated by loads of technical debt, and dozens of heated debates over the most minuscule of changes.

One of the main goals of the project was to avoid the instability of client mods by reimplementing everything from scratch, instead of relying on patching Discord code which can easily break due to updates. In doing so, a lot of things could be omitted or simplified, like the intentional exclusion of nitro features. (i.e. super reactions, profile effects, etc.) Having a clean interface that focused on usability and simplicity while remaining functional was an important design goal.

While Discord doesn't "care" about client mods or 3rd party clients, the truth is that if certain API and gateway requests are incorrect, the account will be flagged in a variety of ways and could cause additional captchas, forcing phone verification, or an outright ban.<ref>{{cite web|title=Cordless shutdown notice|url=https://github.com/Bios-Marcel/cordless?tab=readme-ov-file#i-am-closing-down-the-cordless-project}}</ref> This is one of the major reasons why development took so long since the client must act exactly like a [[v126.21]] Discord client, from the identification sent to the API and gateway, to adhering to all ratelimits, to even spoofing the TLS metadata.<ref>{{cite web|title=JA3 TLS fingerprinting|url=https://github.com/salesforce/ja3}}</ref>

==Architecture==

Opencord is written in [[wikipedia:Kotlin_(programming_language)|Kotlin]] with the use of [https://developer.android.com/jetpack/compose Jetpack Compose], a modern declarative native UI framework for Android. Most of the codebase is based on dependency injection with [https://insert-koin.io Koin], in such a way that it would be theoretically testable in the future. While basic gateway functionality lives independently, most of the complex logic, including caching and live state, lives in [https://github.com/MateriiApps/OpenCord/tree/4e9ed5e92a2879e4e1ccc7aea9b53499e3110f6f/app/src/main/java/com/xinto/opencord/store Stores], a concept taken from the original Discord codebase.

While most of the UI is broken up into small <code>@Composable</code> components, complex UI was wrongly implemented, leading to dozens of recomposition issues that took an insane amount of effort to fix. Additionally, due to the idiomaticity of Compose, complex UI components can be split up into the layout and content, where invoking the layout forces you to provide all the content to the layout. This led to a lot of repetitiveness throughout the codebase, quickly becoming [https://github.com/MateriiApps/OpenCord/blob/4e9ed5e92a2879e4e1ccc7aea9b53499e3110f6f/app/src/main/java/com/xinto/opencord/ui/screens/home/panels/chat/ChatLoaded.kt#L80-L285 unmaintainable]. While this was eventually planned to be refactored out, that never happened. This has been taken into consideration regarding future projects of the developers and it hasn't happened to this extent since.

==Notes==
<references/>

[[Category:Custom Clients]]

Main Page

2024-03-08T17:01:39Z

Rushii: Add uncategorized pages link

{{DISPLAYTITLE:Discord Client Modding Wiki}}
This is a wiki about all sorts of things related to client modding. Not just strictly Vencord, but also anything about other mods, or client modding lore!

Join us in the <code>#vencord-wiki</code> channel in our [https://vencord.dev/discord Discord] if you would like to contribute, or instead check out a [[Special:Random|random article]]!

==Main sections==

* [[:Category:Client Mods]]
* [[:Category:Custom Clients]]
* [[Special:UncategorizedPages]]

DeadSystemException

2024-03-08T16:58:03Z

Rushii: Improve page content and history

An [https://developer.android.com/reference/android/os/DeadSystemException Android error] that is thrown when the system is dead.

This error can be sometimes be thrown on certain devices randomly when using Aliucord's [https://github.com/rushiiMachine/aliucord-plugins/tree/master/AudioPlayer AudioPlayer] plugin.
Nobody knows how or why AudioPlayer is causing that error, because the system crashes into recovery afterwards<ref>{{cite web|title=Aliucord Discord message|url=https://discord.com/channels/811255666990907402/811261478875299840/924777944671461417}}</ref> and the logs are only accessible with root.<ref>{{cite web|title=Aliucord Discord message|url=https://discord.com/channels/811255666990907402/811261478875299840/924418278225485845}}</ref>

{{codesample|lang=java|title=A sample DeadSystemException|
java.lang.RuntimeException: android.os.DeadSystemException
at android.view.ViewRootImpl.systemGestureExclusionChanged(ViewRootImpl.java:4671)
at android.view.ViewRootImpl$ViewRootHandler.handleMessage(ViewRootImpl.java:5582)
at android.os.Handler.dispatchMessage(Handler.java:106)
at android.os.Looper.loop(Looper.java:233)
at android.app.ActivityThread.main(ActivityThread.java:8035)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:631)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:978)
Caused by: android.os.DeadSystemException
... 8 more
}}

==Notes==
<references/>

Template:Codesample/doc

2024-03-08T16:54:06Z