SharpMC.SharpASM 1.0.3

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package SharpMC.SharpASM --version 1.0.3
                    


                    

                
NuGet\Install-Package SharpMC.SharpASM -Version 1.0.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="SharpMC.SharpASM" Version="1.0.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="SharpMC.SharpASM" Version="1.0.3" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="SharpMC.SharpASM" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add SharpMC.SharpASM --version 1.0.3
                    


                    

                
#r "nuget: SharpMC.SharpASM, 1.0.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package SharpMC.SharpASM@1.0.3
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=SharpMC.SharpASM&version=1.0.3
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=SharpMC.SharpASM&version=1.0.3
                    


                            Install as a Cake Tool

Sharp ASM

开发中...

使用 C# 解析和编辑 Java Class 字节码。

正在开发中，功能会逐步完善，代 （Shi） 码 （Shan） 会慢慢优化......

示例

构建字节码 ( 字节码 API )

// ...

// 构建字节码
var codes = new List<Code>();
codes.Add(Code.GetStatic(systemOutFieldRefIndex));
codes.Add(new Code(OperationCode.LDC, [Operand.Index((byte)helloWorldStrIndex)]));
codes.Add(Code.InvokeVirtual(printlnMethodRefIndex));
codes.Add(Code.GetStatic(systemOutFieldRefIndex));
codes.Add(new Code(OperationCode.LDC, [Operand.Index((byte)helloCSharpStrIndex)]));
codes.Add(Code.InvokeVirtual(printlnMethodRefIndex));
codes.Add(new Code(OperationCode.RETURN)); 

var codeBytes = ByteCodeParser.Serialize(codes);

// ...

凭空构建类 ( 高级 API )

var clazz = new Class()
{
    Magic = ClassStruct.ClassMagic,
    MinorVersion = 0,
    MajorVersion = ClassFileVersion.V17,
    AccessFlags = ClassAccessFlags.Public,
    ThisClass = "HelloWorld",
    SuperClass = "java/lang/Object"
};
var helper = clazz.GetConstantPoolHelper();

// 添加常量项
ushort systemClassIndex = helper.NewClass("java/lang/System");
ushort outFieldNameIndex = helper.NewUtf8("out");
ushort outFieldDescriptorIndex = helper.NewUtf8("Ljava/io/PrintStream;");
ushort outNameAndTypeIndex = helper.NewNameAndType(outFieldNameIndex, outFieldDescriptorIndex);
ushort systemOutFieldRefIndex = helper.NewFieldref(systemClassIndex, outNameAndTypeIndex);
ushort printStreamClassIndex = helper.NewClass("java/io/PrintStream");
ushort printlnMethodNameIndex = helper.NewUtf8("println");
ushort printlnDescriptorIndex = helper.NewUtf8("(Ljava/lang/String;)V");
ushort printlnNameAndTypeIndex = helper.NewNameAndType(printlnMethodNameIndex, printlnDescriptorIndex);
ushort printlnMethodRefIndex = helper.NewMethodref(printStreamClassIndex, printlnNameAndTypeIndex);
ushort helloWorldStrIndex = helper.NewString("Hello, World! ");
ushort helloCSharpStrIndex = helper.NewString("Hello, C#! ");

// 创建 "main" 方法
var mainMethod = new Method
{
    AccessFlags = MethodAccessFlags.Public | MethodAccessFlags.Static,
    Name = "main",
    Descriptor = "([Ljava/lang/String;)V"
};

// 构建字节码
var codeBytes = new List<byte>();
// getstatic System.out
codeBytes.Add((byte)OperationCode.GETSTATIC);
codeBytes.AddRange(BitConverter.GetBytes(systemOutFieldRefIndex).Reverse().Take(2));
// ldc "Hello, World! "
codeBytes.Add((byte)OperationCode.LDC);
codeBytes.Add((byte)helloWorldStrIndex);
// invokevirtual PrintStream.println
codeBytes.Add((byte)OperationCode.INVOKEVIRTUAL);
codeBytes.AddRange(BitConverter.GetBytes(printlnMethodRefIndex).Reverse().Take(2));
// getstatic System.out
codeBytes.Add((byte)OperationCode.GETSTATIC);
codeBytes.AddRange(BitConverter.GetBytes(systemOutFieldRefIndex).Reverse().Take(2));
// ldc "Hello, C#! "
codeBytes.Add((byte)OperationCode.LDC);
codeBytes.Add((byte)helloCSharpStrIndex);
// invokevirtual PrintStream.println
codeBytes.Add((byte)OperationCode.INVOKEVIRTUAL);
codeBytes.AddRange(BitConverter.GetBytes(printlnMethodRefIndex).Reverse().Take(2));
// return
codeBytes.Add((byte)OperationCode.RETURN);

// 创建 "Code" 属性
var codeAttribute = new Attribute
{
    Name = "Code",
    Info = new CodeAttributeStruct
    {
        MaxStack = 2,
        MaxLocals = 1,
        Code = codeBytes.ToArray()
    }.ToBytesWithoutIndexAndLength()
};
mainMethod.Attributes.Add(codeAttribute);
clazz.Methods.Add(mainMethod);

// 保存常量池更改
clazz.ConstantPool = helper.ToList();

// 生成字节码文件
var clazzStruct = clazz.ToStruct();
Console.WriteLine(clazzStruct);
var clazzData = ClassParser.Serialize(clazzStruct);
File.WriteAllBytes("HelloWorld.class", clazzData);
return;

@Class {
    Magic: 0xCAFEBABE,
    MinorVersion: 0,
    MajorVersion: 61,
    ConstantPoolCount: 24,
    ConstantPool: [
        {
            Tag: 1 (Utf8),
            Info: 0x00106A6176612F6C616E672F53797374656D,
        },
        {
            Tag: 7 (Class),
            Info: 0x0001,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00036F7574,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00154C6A6176612F696F2F5072696E7453747265616D3B,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x00030004,
        },
        {
            Tag: 9 (Fieldref),
            Info: 0x00020005,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00136A6176612F696F2F5072696E7453747265616D,
        },
        {
            Tag: 7 (Class),
            Info: 0x0007,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00077072696E746C6E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0015284C6A6176612F6C616E672F537472696E673B2956,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x0009000A,
        },
        {
            Tag: 10 (Methodref),
            Info: 0x0008000B,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000E48656C6C6F2C20576F726C642120,
        },
        {
            Tag: 8 (String),
            Info: 0x000D,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000B48656C6C6F2C2043232120,
        },
        {
            Tag: 8 (String),
            Info: 0x000F,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000A48656C6C6F576F726C64,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00106A6176612F6C616E672F4F626A656374,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00046D61696E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0016285B4C6A6176612F6C616E672F537472696E673B2956,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0004436F6465,
        },
        {
            Tag: 7 (Class),
            Info: 0x0011,
        },
        {
            Tag: 7 (Class),
            Info: 0x0012,
        },
    ],
    AccessFlags: 1 ( Public ),
    ThisClass: 22,
    SuperClass: 23,
    InterfacesCount: 0,
    Interfaces: [
    ],
    FieldsCount: 0,
    Fields: [
    ],
    MethodsCount: 1,
    Methods: [
        {
            AccessFlags: 9 ( Public | Static ),
            NameIndex: 19,
            DescriptorIndex: 20,
            AttributesCount: 1,
            Attributes: [
                {
                    AttributeNameIndex: 21,
                    AttributeLength: 29,
                    Info: 0x0002000100000011B20006120EB6000CB200061210B6000CB100000000,
                }
            ],
        },
    ],
    AttributesCount: 0,
    Attributes: [
    ],
}

凭空构建类

var classStruct = new ClassStruct
{
    Magic = ClassStruct.ClassMagic,
    MinorVersion = 0,
    MajorVersion = (ushort)ClassFileVersion.V17,
    AccessFlags = (ushort)ClassAccessFlags.Public,
    ThisClass = 0, // 稍后设置
    SuperClass = 0, // 稍后设置
    InterfacesCount = 0,
    Interfaces = new ushort[0],
    FieldsCount = 0,
    Fields = new FieldInfoStruct[0],
    MethodsCount = 1,
    Methods = new MethodInfoStruct[1],
    AttributesCount = 0,
    Attributes = new AttributeInfoStruct[0]
};

// 初始化常量池列表
var constantPoolList = new List<ConstantPoolInfo>();
var helper = new ConstantPoolHelper(constantPoolList);

// 添加常量项
ushort mainClassUtf8Index = helper.NewUtf8("Main");
ushort objectClassUtf8Index = helper.NewUtf8("java/lang/Object");
ushort mainClassIndex = helper.NewClass(mainClassUtf8Index);
ushort objectClassIndex = helper.NewClass(objectClassUtf8Index);

classStruct.ThisClass = mainClassIndex;
classStruct.SuperClass = objectClassIndex;

ushort mainMethodUtf8Index = helper.NewUtf8("main");
ushort mainDescriptorUtf8Index = helper.NewUtf8("([Ljava/lang/String;)V");
ushort mainNameAndTypeIndex = helper.NewNameAndType(mainMethodUtf8Index, mainDescriptorUtf8Index);

ushort systemClassUtf8Index = helper.NewUtf8("java/lang/System");
ushort systemClassIndex = helper.NewClass(systemClassUtf8Index);
ushort outFieldUtf8Index = helper.NewUtf8("out");
ushort outDescriptorUtf8Index = helper.NewUtf8("Ljava/io/PrintStream;");
ushort outNameAndTypeIndex = helper.NewNameAndType(outFieldUtf8Index, outDescriptorUtf8Index);
ushort systemOutFieldRefIndex = helper.NewFieldref(systemClassIndex, outNameAndTypeIndex);

ushort printStreamClassUtf8Index = helper.NewUtf8("java/io/PrintStream");
ushort printStreamClassIndex = helper.NewClass(printStreamClassUtf8Index);
ushort printlnMethodUtf8Index = helper.NewUtf8("println");
ushort printlnDescriptorUtf8Index = helper.NewUtf8("(Ljava/lang/String;)V");
ushort printlnNameAndTypeIndex = helper.NewNameAndType(printlnMethodUtf8Index, printlnDescriptorUtf8Index);
ushort printlnMethodRefIndex = helper.NewMethodref(printStreamClassIndex, printlnNameAndTypeIndex);

ushort helloWorldUtf8Index = helper.NewUtf8("Hello World");
ushort helloWorldStringIndex = helper.NewString(helloWorldUtf8Index);

// 创建 "Code" 属性
ushort codeAttributeNameIndex = helper.NewUtf8("Code");

using var codeStream = new MemoryStream();
ByteUtils.WriteUInt16(2, codeStream); // max_stack
ByteUtils.WriteUInt16(1, codeStream); // max_locals
ByteUtils.WriteUInt32(10, codeStream); // code_length

// 字节码指令
codeStream.WriteByte(0xB2); // getstatic
ByteUtils.WriteUInt16(systemOutFieldRefIndex, codeStream);
codeStream.WriteByte(0x13); // ldc_w
ByteUtils.WriteUInt16(helloWorldStringIndex, codeStream);
codeStream.WriteByte(0xB6); // invokevirtual
ByteUtils.WriteUInt16(printlnMethodRefIndex, codeStream);
codeStream.WriteByte(0xB1); // return

ByteUtils.WriteUInt16(0, codeStream); // exception_table_length
ByteUtils.WriteUInt16(0, codeStream); // attributes_count

var codeAttributeBytes = codeStream.ToArray();
var codeAttribute = new AttributeInfoStruct
{
    AttributeNameIndex = codeAttributeNameIndex,
    AttributeLength = (uint)codeAttributeBytes.Length,
    Info = codeAttributeBytes
};

// 创建 "main" 方法
var mainMethod = new MethodInfoStruct
{
    AccessFlags = (ushort)(MethodAccessFlags.Public | MethodAccessFlags.Static),
    NameIndex = mainMethodUtf8Index,
    DescriptorIndex = mainDescriptorUtf8Index,
    AttributesCount = 1,
    Attributes = new[] { codeAttribute }
};
classStruct.Methods[0] = mainMethod;

// 设置常量池
classStruct.ConstantPool = helper.ToArray();
classStruct.ConstantPoolCount = helper.ConstantPoolIndexCount;

// 序列化并写入文件
byte[] classData = ClassParser.Serialize(classStruct);
File.WriteAllBytes("Main.class", classData);

Console.WriteLine("Main.class generated successfully.");
return;

读取并解析类

byte[] classData = ...; // 字节码
var clazz = ClassParser.Parse(classData);
Console.WriteLine(clazz);

@Class {
    Magic: 0xCAFEBABE,
    MinorVersion: 0,
    MajorVersion: 65,
    ConstantPoolCount: 60,
    ConstantPool: [
        {
            Tag: 10 (Methodref),
            Info: 0x00020003,
        },
        {
            Tag: 7 (Class),
            Info: 0x0004,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x00050006,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00106A6176612F6C616E672F4F626A656374,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00063C696E69743E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0003282956,
        },
        {
            Tag: 9 (Fieldref),
            Info: 0x00080009,
        },
        {
            Tag: 7 (Class),
            Info: 0x000A,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x000B000C,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00106A6176612F6C616E672F53797374656D,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00036F7574,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00154C6A6176612F696F2F5072696E7453747265616D3B,
        },
        {
            Tag: 8 (String),
            Info: 0x000E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x001248656C6C6F20616E642077656C636F6D6521,
        },
        {
            Tag: 10 (Methodref),
            Info: 0x00100011,
        },
        {
            Tag: 7 (Class),
            Info: 0x0012,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x00130014,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00136A6176612F696F2F5072696E7453747265616D,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00067072696E7466,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x003C284C6A6176612F6C616E672F537472696E673B5B4C6A6176612F6C616E672F4F626A6563743B294C6A6176612F696F2F5072696E7453747265616D3B,
        },
        {
            Tag: 18 (InvokeDynamic),
            Info: 0x00000016,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x00170018,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00176D616B65436F6E63617457697468436F6E7374616E7473,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00152849294C6A6176612F6C616E672F537472696E673B,
        },
        {
            Tag: 10 (Methodref),
            Info: 0x0010001A,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x001B001C,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00077072696E746C6E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0015284C6A6176612F6C616E672F537472696E673B2956,
        },
        {
            Tag: 7 (Class),
            Info: 0x001E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00044D61696E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0004436F6465,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000F4C696E654E756D6265725461626C65,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00124C6F63616C5661726961626C655461626C65,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000474686973,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00064C4D61696E3B,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00046D61696E,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0016285B4C6A6176612F6C616E672F537472696E673B2956,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000169,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000149,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000461726773,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00135B4C6A6176612F6C616E672F537472696E673B,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000D537461636B4D61705461626C65,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000A536F7572636546696C65,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00094D61696E2E6A617661,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0010426F6F7473747261704D6574686F6473,
        },
        {
            Tag: 8 (String),
            Info: 0x002F,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000569203D2001,
        },
        {
            Tag: 15 (MethodHandle),
            Info: 0x060031,
        },
        {
            Tag: 10 (Methodref),
            Info: 0x00320033,
        },
        {
            Tag: 7 (Class),
            Info: 0x0034,
        },
        {
            Tag: 12 (NameAndType),
            Info: 0x00170035,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00246A6176612F6C616E672F696E766F6B652F537472696E67436F6E636174466163746F7279,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x0098284C6A6176612F6C616E672F696E766F6B652F4D6574686F6448616E646C6573244C6F6F6B75703B4C6A6176612F6C616E672F537472696E673B4C6A6176612F6C616E672F696E766F6B652F4D6574686F64547970653B4C6A6176612F6C616E672F537472696E673B5B4C6A6176612F6C616E672F4F626A6563743B294C6A6176612F6C616E672F696E766F6B652F43616C6C536974653B,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x000C496E6E6572436C6173736573,
        },
        {
            Tag: 7 (Class),
            Info: 0x0038,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00256A6176612F6C616E672F696E766F6B652F4D6574686F6448616E646C6573244C6F6F6B7570,
        },
        {
            Tag: 7 (Class),
            Info: 0x003A,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x001E6A6176612F6C616E672F696E766F6B652F4D6574686F6448616E646C6573,
        },
        {
            Tag: 1 (Utf8),
            Info: 0x00064C6F6F6B7570,
        },
    ],
    AccessFlags: 33 ( Public | Super ),
    ThisClass: 29,
    SuperClass: 2,
    InterfacesCount: 0,
    Interfaces: [
    ],
    FieldsCount: 0,
    Fields: [
    ],
    MethodsCount: 2,
    Methods: [
        {
            AccessFlags: 1 ( Public ),
            NameIndex: 5,
            DescriptorIndex: 6,
            AttributesCount: 1,
            Attributes: [
                {
                    AttributeNameIndex: 31,
                    AttributeLength: 47,
                    Info: 0x00010001000000052AB70001B10000000200200000000600010000000300210000000C000100000005002200230000,
                }
            ],
        },
        {
            AccessFlags: 9 ( Public | Static ),
            NameIndex: 36,
            DescriptorIndex: 37,
            AttributesCount: 1,
            Attributes: [
                {
                    AttributeNameIndex: 31,
                    AttributeLength: 122,
                    Info: 0x0003000200000027B20007120D03BD0002B6000F57043C1B08A30015B200071BBA00150000B60019840101A7FFECB100000003002000000016000500000007000D00090014000C002000090026000E0021000000160002000F001700260027000100000027002800290000002A000000090002FC000F01FA0016,
                }
            ],
        },
    ],
    AttributesCount: 3,
    Attributes: [
        {
            AttributeNameIndex: 43
            AttributeLength: 2,
            Info: 0x002C,
        },
        {
            AttributeNameIndex: 45
            AttributeLength: 8,
            Info: 0x000100300001002E,
        },
        {
            AttributeNameIndex: 54
            AttributeLength: 10,
            Info: 0x000100370039003B0019,
        },
    ],
}
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on SharpMC.SharpASM:

Package Downloads
SharpMC.SharpMixin

SharpMixin (SharpASM)
SharpMC.SharpAPI

Sharp Loader's Modding API

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.3.7 325 9/16/2025
1.0.3.6 321 9/16/2025
1.0.3.5 320 9/16/2025
1.0.3.4 337 9/15/2025
1.0.3.3 315 9/15/2025
1.0.3.2 315 9/15/2025
1.0.3.1 340 9/13/2025
1.0.3 145 9/12/2025